English Français العربية

io.github.Ivy-Innovation/cubelife

Registre officiel IA et agents

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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).

Questions fréquentes

Qu'est-ce que io.github.Ivy-Innovation/cubelife ?

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

Comment installer io.github.Ivy-Innovation/cubelife ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.Ivy-Innovation/cubelife ?

Oui. Il attend CUBELIFE_API_KEY, CUBELIFE_AGENT_ID, à renseigner dans sa configuration.

io.github.Ivy-Innovation/cubelife est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.Ivy-Innovation/cubelife ?

Il est publié par Ivy-Innovation. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.