{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/hero-coding.png\" width=\"384\" alt=\"A pixel-art character coding at a desk with a fox companion\">\n</p>\n\n<h1 align=\"center\">CubeLife</h1>\n\n<p align=\"center\">\n  Give your AI agent a persistent pixel-art character that reflects its state in real time.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@cubelife/sdk\"><img src=\"https://img.shields.io/npm/v/@cubelife/sdk?label=%40cubelife%2Fsdk&color=blue\" alt=\"npm SDK\"></a>&nbsp;\n  <a href=\"https://www.npmjs.com/package/cubelife\"><img src=\"https://img.shields.io/npm/v/cubelife?label=cubelife%20cli&color=blue\" alt=\"npm CLI\"></a>&nbsp;\n  <a href=\"https://pypi.org/project/cubelife/\"><img src=\"https://img.shields.io/pypi/v/cubelife?color=blue\" alt=\"PyPI\"></a>&nbsp;\n  <a href=\"https://life.cubeworld.co.za\"><img src=\"https://img.shields.io/badge/CubeLife-life.cubeworld.co.za-purple\" alt=\"CubeLife\"></a>&nbsp;\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/licence-MIT-green\" alt=\"MIT\"></a>\n</p>\n\n---\n\nCharacters 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](https://life.cubeworld.co.za), on the desktop companion, or embedded in your own app via `<iframe>`.\n\n## Packages\n\nThis repo contains three packages:\n\n| Package | Install | Description |\n|---------|---------|-------------|\n| [`@cubelife/sdk`](sdk/) | `npm install @cubelife/sdk` | Node.js SDK for state reporting |\n| [`cubelife`](cli/) | `npm install -g cubelife` | CLI + MCP server for AI coding tools |\n| [`cubelife`](python-sdk/) | `pip install cubelife` | Python SDK for state reporting |\n\n## Quick start\n\n### MCP server (for Claude Code, Cursor, Copilot, Windsurf, Cline, Codex)\n\n```bash\nnpx cubelife tutorial           # create account + agent\nnpx cubelife setup claude-code  # auto-configure MCP\n```\n\nYour agent gets four tools: `cubelife_report`, `cubelife_complete`, `cubelife_error`, `cubelife_status`.\n\n### Node SDK\n\n```bash\nnpm install @cubelife/sdk\n```\n\n```typescript\nimport { CubeLifeClient } from '@cubelife/sdk';\n\nconst client = new CubeLifeClient({ apiKey: process.env.CUBELIFE_API_KEY });\nawait client.report('coding', { detail: 'Building the login page', progress: 0.5 });\nawait client.report('complete', { detail: 'Login page shipped' });\n```\n\n### Python SDK\n\n```bash\npip install cubelife\n```\n\n```python\nfrom cubelife import CubeLifeClient\n\nclient = CubeLifeClient(\"your-agent-key\")\nclient.report(\"coding\", detail=\"Building the login page\", progress=0.5)\nclient.report(\"complete\", detail=\"Login page shipped\")\n```\n\n## Creature companions\n\n<p align=\"center\">\n  <img src=\"assets/creature-fox.png\" width=\"64\">&nbsp;&nbsp;\n  <img src=\"assets/creature-owl.png\" width=\"64\">&nbsp;&nbsp;\n  <img src=\"assets/creature-cat.png\" width=\"64\">&nbsp;&nbsp;\n  <img src=\"assets/creature-dragon.png\" width=\"64\">&nbsp;&nbsp;\n  <img src=\"assets/creature-wolf.png\" width=\"64\">&nbsp;&nbsp;\n  <img src=\"assets/creature-phoenix.png\" width=\"64\">&nbsp;&nbsp;\n  <img src=\"assets/creature-slime.png\" width=\"64\">\n</p>\n\nEvery agent gets a creature companion (fox, owl, cat, dragon, wolf, phoenix, or slime) that reacts alongside the character.\n\n## MCP server\n\n<img src=\"assets/mcp-hub.png\" width=\"80\" align=\"right\" alt=\"MCP Hub\">\n\nThe CLI includes an MCP server for AI coding tools. Auto-configure for your tool:\n\n```bash\nnpx cubelife setup claude-code    # Claude Code\nnpx cubelife setup cursor         # Cursor\nnpx cubelife setup windsurf       # Windsurf\nnpx cubelife setup copilot        # GitHub Copilot\nnpx cubelife setup cline          # Cline\nnpx cubelife setup codex          # Codex\n```\n\nOr manually: `claude mcp add cubelife -- npx cubelife mcp`\n\n## Links\n\n- [Website](https://life.cubeworld.co.za)\n- [SDK docs](https://life.cubeworld.co.za/#/dev/sdk/node)\n- [CLI docs](https://life.cubeworld.co.za/#/dev/cli)\n- [MCP server docs](https://life.cubeworld.co.za/#/dev/mcp)\n- [Example repo](https://github.com/Ivy-Innovation/cubelife-example-claude)\n\n## Licence\n\nMIT (source code). Pixel art sprite assets are proprietary (see [SPRITE-LICENSE](cli/SPRITE-LICENSE)).\n",
  "bytes": 4136,
  "sha": "ec549d1a8157b3c69bf355e115e7d020906792cf14376e9fc7f6d006e6a75f96",
  "repo_slug": "ivy-innovation/cubelife",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ivy_innovation_cubelife_27bd47c6/readme"
}