English Français العربية

io.github.Ivy-Innovation/cubelife

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • CUBELIFE_API_KEY إلزامي سري Agent API key from the CubeLife dashboard
  • CUBELIFE_AGENT_ID إلزامي Agent ID from the CubeLife dashboard

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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).

الأسئلة الشائعة

ما هو io.github.Ivy-Innovation/cubelife؟

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

كيف أثبّت io.github.Ivy-Innovation/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Ivy-Innovation/cubelife إلى مفتاح API؟

نعم. يتطلب CUBELIFE_API_KEY, CUBELIFE_AGENT_ID، وتضبطها في إعداداته.

هل io.github.Ivy-Innovation/cubelife مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Ivy-Innovation/cubelife؟

ينشره Ivy-Innovation. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.