This gives your AI coding assistant a persistent pixel-art character that visually reflects what it's doing in real time. It exposes four MCP tools: cubelife_report for state updates like "coding" or "thinking", cubelife_complete for marking tasks done, cubelife_error for failures, and cubelife_status for checking current state. The character lives in a pixel-art room at life.cubeworld.co.za with a creature companion (fox, owl, cat, dragon, wolf, phoenix, or slime) that reacts alongside it. Includes auto-setup commands for Claude Code, Cursor, Windsurf, Copilot, Cline, and Codex. Reach for this when you want ambient awareness of what your agent is actually doing without parsing logs or chat history.
CUBELIFE_API_KEY*secretAgent API key from the CubeLife dashboard
CUBELIFE_AGENT_ID*Agent ID from the CubeLife dashboard
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>.
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 |
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.
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' });
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")
Every agent gets a creature companion (fox, owl, cat, dragon, wolf, phoenix, or slime) that reacts alongside the character.
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
MIT (source code). Pixel art sprite assets are proprietary (see SPRITE-LICENSE).