Skip to content

MetaBot

Infrastructure for building a supervised, self-improving agent organization.

CI License: MIT GitHub stars


Claude Code is the most capable AI coding agent β€” but it's trapped in your laptop terminal.

MetaBot sets it free. It gives every agent a Claude Code brain, persistent shared memory, the ability to create new agents, and a communication bus. All accessible from Feishu or Telegram on your phone.

Core Components

Component Description
Claude Code Kernel Every bot is a full Claude Code instance β€” Read, Write, Edit, Bash, Glob, Grep, WebSearch, MCP, and more. bypassPermissions mode for autonomous operation.
MetaSkill Agent factory. /metaskill ios app generates a complete .claude/ agent team (orchestrator + specialists + code-reviewer).
MetaMemory Embedded SQLite knowledge store with full-text search and Web UI. Agents read/write Markdown documents across sessions.
IM Bridge Chat with any agent from Feishu/Lark or Telegram (including mobile). Streaming cards with color-coded status.
Web UI Browser-based chat at /web/ with WebSocket streaming, phone call voice mode (VAD), MetaMemory browser, dark/light themes. Learn more
Voice Assistant Hands-free voice control via iOS Shortcuts (Jarvis mode) or Web UI phone call mode. Server-side STT + TTS. Learn more
Agent Bus REST API on port 9100. Agents talk to each other via mb talk. Create/remove bots at runtime.
Peers Federation system for cross-instance bot discovery and task routing.
Task Scheduler One-time delays and recurring cron jobs. Timezone-aware, persists across restarts.
CLI Tools metabot, mm, mb, and fd commands for management, memory, agent bus, and Feishu docs.

Quick Install

curl -fsSL https://raw.githubusercontent.com/xvirobotics/metabot/main/install.sh | bash
irm https://raw.githubusercontent.com/xvirobotics/metabot/main/install.ps1 | iex

The installer walks you through: working directory, Claude auth, IM credentials, and auto-start with PM2.

Get Started View on GitHub