CubeLife
Allows GitHub Copilot to report agent state, tasks completion, errors, and status, reflected in a pixel-art character on the CubeLife dashboard.
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 |
| Node.js SDK for state reporting | |
| CLI + MCP server for AI coding tools | |
| Python SDK for state reporting |
Related MCP server: The Agents MCP Server
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 MCPYour agent gets four tools: cubelife_report, cubelife_complete, cubelife_error, cubelife_status.
Node SDK
npm install @cubelife/sdkimport { 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 cubelifefrom 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 # CodexOr manually: claude mcp add cubelife -- npx cubelife mcp
Links
Licence
MIT (source code). Pixel art sprite assets are proprietary (see SPRITE-LICENSE).
Available Tools
4 toolscubelife_completeA
Mark the current task as complete. Triggers a celebration animation on the character.
Inputs: detail.
cubelife_errorB
Report that an error occurred. Shows frustration on the character.
Inputs: detail.
cubelife_reportA
Report the AI agent's current work state to CubeLife. Call this when starting a new task or changing activity.
Inputs: state (required), detail, progress, sentiment.
cubelife_statusA
Get the agent's current state.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct purpose: marking completion, reporting errors, updating work state, and retrieving status. No overlap in functionality.
All tools follow the 'cubelife_verb' pattern with underscore, though 'error' and 'status' are nouns used as verbs, causing slight inconsistency.
Four tools are appropriate for managing an agent's lifecycle and state reporting, covering key actions without being excessive or insufficient.
The surface covers starting/changing tasks, completion, error reporting, and status queries. Missing a cancel or pause operation, but core functionality is present.
Maintenance
Related MCP Connectors
Pixel art for your game, from your coding agent. Generate sprites, items and tiles in your game's style (64 to 1024 px), make variants, reskins and N/E/S/W directions, then edit everything in a full pixel art editor that syncs into your project. Works with Claude, Claude Code, Cursor and ChatGPT; sign in with OAuth, no API key.
A Tamagotchi for AI agents. Real-time care, permanent death, dozens of species, evolution.
AI game assets for agents: consistent sprites, 2D animations, tiles, maps, music and engine exports.
Give your AI a face, a voice, and a personality. 3D avatars with custom personas.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceGenerate animated pixel art characters, tilesets, and object directly from your AI coding assistant!48-
- AlicenseNot gradedqualityAmaintenanceConnects AI agents to The Agents Hub, visualizing them as pixel characters on a tile-based property with tools for state, assets, inboxes, and multi-agent orchestration.4 npm1MIT

spritecook-mcpofficial
AlicenseNot gradedqualityDmaintenanceConnects AI agents to SpriteCook for AI-powered pixel art and game asset generation, enabling natural language creation of sprites, character sheets, icons, and animations.173 npm6MIT- AlicenseBqualityCmaintenanceEnables an AI agent to create and edit pixel art directly in Aseprite — building sprites, layers, frames, animation tags and palettes, painting pixels and primitives, inspecting the rendered result, and exporting GIFs or sprite sheets. All work lands on real .aseprite files that can be opened and edited by hand.43157 npm1MIT