npm cubelifestdioMITupdated 3mo ago
Give your AI agent a persistent pixel-art character that reflects its state in real time.
O que dá para fazer com cubelife?
Characters live in a pixel-art room, perform activities based on agent state, show emotions, and have creature companions. View them at life.cubeworld.co.za, on the desktop companion, or embedded in your own app via <iframe>.
Packages
This repo contains three packages:
| Package | Install | Description |
|---|---|---|
@cubelife/sdk |
npm install @cubelife/sdk |
Node.js SDK for state reporting |
cubelife |
npm install -g cubelife |
CLI + MCP server for AI coding tools |
cubelife |
pip install cubelife |
Python SDK for state reporting |
Quick start
MCP server (for Claude Code, Cursor, Copilot, Windsurf, Cline, Codex)
npx cubelife tutorial # create account + agent
npx cubelife setup claude-code # auto-configure MCP
Your agent gets four tools: cubelife_report, cubelife_complete, cubelife_error, cubelife_status.
Node SDK
npm install @cubelife/sdk
import { CubeLifeClient } from '@cubelife/sdk';
const client = new CubeLifeClient({ apiKey: process.env.CUBELIFE_API_KEY });
await client.report('coding', { detail: 'Building the login page', progress: 0.5 });
await client.report('complete', { detail: 'Login page shipped' });
Python SDK
pip install cubelife
from cubelife import CubeLifeClient
client = CubeLifeClient("your-agent-key")
client.report("coding", detail="Building the login page", progress=0.5)
client.report("complete", detail="Login page shipped")
Creature companions
Every agent gets a creature companion (fox, owl, cat, dragon, wolf, phoenix, or slime) that reacts alongside the character.
MCP server
The CLI includes an MCP server for AI coding tools. Auto-configure for your tool:
npx cubelife setup claude-code # Claude Code
npx cubelife setup cursor # Cursor
npx cubelife setup windsurf # Windsurf
npx cubelife setup copilot # GitHub Copilot
npx cubelife setup cline # Cline
npx cubelife setup codex # Codex
Or manually: claude mcp add cubelife -- npx cubelife mcp
Links
Licence
MIT (source code). Pixel art sprite assets are proprietary (see SPRITE-LICENSE).
Instalação
Adicione cubelife ao seu cliente. Escolha o que você usa.
claude mcp add cubelife -- npx -y cubelifecodex mcp add cubelife -- npx -y cubelifeamp mcp add cubelife -- npx -y cubelife{
"mcpServers": {
"cubelife": {
"command": "npx",
"args": [
"-y",
"cubelife"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"cubelife": {
"command": "npx",
"args": [
"-y",
"cubelife"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"cubelife","command":"npx","args":["-y","cubelife"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"cubelife": {
"command": "npx",
"args": [
"-y",
"cubelife"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"cubelife": {
"command": "npx",
"args": [
"-y",
"cubelife"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"cubelife": {
"command": "npx",
"args": [
"-y",
"cubelife"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"cubelife": {
"type": "local",
"command": "npx",
"args": [
"-y",
"cubelife"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"cubelife": {
"command": {
"path": "npx",
"args": [
"-y",
"cubelife"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y cubelifeRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Pontuação
39 / 100
Incompleta
- Documentação25/25
- Manutenção16/25
- Confiança16/20
- Capacidade0/15
- Instalação12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 89 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Histórico de versões
| Versões | Publicada |
|---|---|
| 0.3.2Mais recente | 3 de jun. de 2026 |