English Français العربية

io.github.Ivy-Innovation/cubelife

Official registry AI and agents

Give AI agents a persistent pixel-art character reflecting their state in real time.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package cubelife
Claude Code 
claude mcp add cubelife -e 'CUBELIFE_API_KEY=<your cubelife_api_key>' -e 'CUBELIFE_AGENT_ID=<CUBELIFE_AGENT_ID>' -- npx -y cubelife@0.3.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "cubelife": {
            "command": "npx",
            "args": [
                "-y",
                "cubelife@0.3.2"
            ],
            "env": {
                "CUBELIFE_API_KEY": "<your cubelife_api_key>",
                "CUBELIFE_AGENT_ID": "<CUBELIFE_AGENT_ID>"
            }
        }
    }
}

Environment variables

  • CUBELIFE_API_KEY required secret Agent API key from the CubeLife dashboard
  • CUBELIFE_AGENT_ID required Agent ID from the CubeLife dashboard

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. CubeLife
  2. Packages
  3. Quick start
  4. Creature companions
  5. MCP server
  6. Links
  7. Licence

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:

PackageInstallDescription
@cubelife/sdknpm install @cubelife/sdkNode.js SDK for state reporting
cubelifenpm install -g cubelifeCLI + MCP server for AI coding tools
cubelifepip install cubelifePython 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

Licence

MIT (source code). Pixel art sprite assets are proprietary (see SPRITE-LICENSE).

Frequently asked questions

What is io.github.Ivy-Innovation/cubelife?

Give AI agents a persistent pixel-art character reflecting their state in real time.

How do I install io.github.Ivy-Innovation/cubelife?

It runs on your machine. In Claude Code: claude mcp add cubelife -e 'CUBELIFE_API_KEY=<your cubelife_api_key>' -e 'CUBELIFE_AGENT_ID=<CUBELIFE_AGENT_ID>' -- npx -y cubelife@0.3.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Ivy-Innovation/cubelife need an API key?

Yes. It expects CUBELIFE_API_KEY, CUBELIFE_AGENT_ID, which you set in its configuration.

Is io.github.Ivy-Innovation/cubelife open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Ivy-Innovation/cubelife?

It is published by Ivy-Innovation. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.