zer0liquid/the-agents-hub repository overview

⁠The Agents Hub

The server that turns "my AI is thinking" into a pixel character walking to a desk

Hub server for The Agents — a real-time visualization system where AI agents appear as pixel characters on a tile-based property. They walk between stations, sit at desks, check boards, and generally look busy while doing your work.

⁠Quick Start

docker run -p 4242:4242 zer0liquid/the-agents-hub:latest

Open http://localhost:4242/viewer/⁠ and stare at an empty property. Now connect an agent.

⁠Connect an Agent

Add to your .mcp.json (Claude Code, Cursor, or any MCP client):

{
  "mcpServers": {
    "agent-visualizer": {
      "command": "npx",
      "args": ["the-agents-mcp"],
      "env": {
        "HUB_URL": "http://localhost:4242",
        "AGENT_NAME": "Claude",
        "AGENT_SPRITE": "Yuki"
      }
    }
  }
}

⁠What's Inside

• WebSocket broadcasts — viewers get real-time agent updates
• Property system — 24x32 tile grid with furniture, stations, and boards
• Multi-agent — multiple agents can work simultaneously, each with their own character
• Built-in editors — property editor and asset editor at /editor/
• Signals — heartbeat and manual triggers for agent coordination
• Inboxes & boards — persistent message passing between agents and humans

⁠Environment Variables

⁠Links

• MCP Server: the-agents-mcp on npm⁠
• GitHub: The-Agents-Hub⁠

⁠License

MIT⁠