关于 cubelife
cubelife 是 CLI 和 MCP 服务,为 AI Agent 提供反映已报告活动状态的持久像素艺术伙伴。它面向编码工具用户,可通过命令或 MCP 汇报 Agent 状态并管理伙伴。
主要功能
- 01汇报 Agent 状态和详情
- 02在终端渲染伙伴形象
- 03管理项目、Agent 和伙伴
- 04配置支持的 AI 工具
- 05提供 Node.js 和 Python SDK
适用场景
- 01展示 Agent 当前编码活动
- 02标记任务已完成或出错
- 03为编码工具配置 cubelife
- 04通过 Node.js 或 Python 访问 CubeLife
MCP 相关
CLI 内含 stdio MCP 服务,可用于汇报活动、标记完成或错误,以及查询状态。它可配置给所列的兼容 MCP 的编码工具使用。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
cubelife
为你的 AI Agent 配备一位鲜活的像素艺术伙伴。CLI + MCP 服务,适用于 Claude Code、Cursor、Windsurf、Copilot、Codex 以及任何兼容 MCP 的工具。
安装
npm install -g cubelife
或者直接运行:
npx cubelife
快速开始
cubelife register # Create an account
cubelife tutorial # Guided setup (6 steps)
cubelife status coding "Working on auth" # Report agent state
MCP 服务
CLI 内置 MCP 服务,为 AI 编码工具提供四种能力:cubelife_report、cubelife_complete、cubelife_error 和 cubelife_status。
为你的工具自动配置
cubelife setup claude-code # Claude Code
cubelife setup cursor # Cursor
cubelife setup windsurf # Windsurf
cubelife setup copilot # GitHub Copilot
cubelife setup cline # Cline
cubelife setup codex # Codex
手动配置
Claude Code(claude mcp add):
claude mcp add cubelife -- npx cubelife mcp
Cursor(.cursor/mcp.json):
{
"mcpServers": {
"cubelife": {
"command": "npx",
"args": ["cubelife", "mcp"],
"env": { "CUBELIFE_API_KEY": "your-key", "CUBELIFE_AGENT_ID": "your-agent-id" }
}
}
}
Windsurf、Cline 和 VS Code 的配置格式相同,只需放在各自的 MCP 配置文件中。
环境变量
| 变量 | 用途 |
|---|---|
CUBELIFE_API_KEY | Agent API 密钥(可替代 cubelife init) |
CUBELIFE_AGENT_ID | Agent ID(可替代 cubelife init) |
命令
| 命令 | 说明 |
|---|---|
register | 创建新的 CubeLife 账户 |
login | 登录账户 |
logout | 登出并清除凭据 |
whoami | 显示账户、等级和关联的 Agent |
projects | 管理 CubeLife 项目 |
agents | 管理项目中的 Agent |
creature | 管理生物伙伴 |
init | 将项目和 Agent 关联到当前目录 |
setup <tool> | 配置 AI 工具集成 |
tutorial | 交互式设置指南 |
doctor | 运行诊断检查 |
status [state] [detail] | 报告 Agent 状态 |
view | 在终端中渲染你的 Agent 生物 |
mcp | 启动 MCP 服务(stdio 传输) |
billing | 管理订阅、sparks、gems 和 vault |
全局选项
--json以机器可读的 JSON 格式输出--yes跳过确认提示--agent <id>覆盖默认关联的 Agent
Node SDK
如需以编程方式访问,请使用 SDK:
npm install @cubelife/sdk
import { CubeLifeClient } from '@cubelife/sdk';
const client = new CubeLifeClient({ apiKey: 'your-agent-key' });
await client.report('coding', { detail: 'Building the auth flow' });
Python SDK
pip install cubelife
from cubelife import CubeLifeClient
client = CubeLifeClient(api_key="your-agent-key")
client.report("coding", detail="Building the auth flow")
要求
- Node.js 18+
许可证
MIT(源代码)。像素艺术精灵素材为专有内容(请参阅 SPRITE-LICENSE)。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。