Cubelife
📇 🏠 - Give AI agents a persistent pixel-art character that reflects their state in real time. Report work state, mark tasks complete, signal errors, and check status. Characters live in rooms with emotions and creature companions.
Quick Install
{
"mcpServers": {
"ivy-innovation-cubelife": {
"command": "npx",
"args": [
"-y",
"ivy-innovation-cubelife"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
CubeLife
Give your AI agent a persistent pixel-art character that reflects its state in real time.
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).