How xvirobotics/metabot works
MetaBot is a self-hosted personal agent workspace: a user sends a chat or web request, the Bridge routes it to a configured Codex, Kimi, or Claude engine, and the result returns through the originating channel. Its wider product includes a token-authenticated Core Console and server-backed Agents, Memory, Skills, T5T, Teams, and Agent Bus capabilities, plus scheduling, peers, and document sync. Relationships for sampled Bridge and engine modules are supported by the SOURCE INDEX; broader feature links use the README, since most implementation excerpts were not provided.
Main entry points: message-bridge.ts Message bridge · server.ts Core server · index.ts Engine selection · event-handler.ts Feishu adapter
Components 26
Chat channels
- Feishu adapter
src/feishu/event-handler.ts - Telegram bot
src/telegram/telegram-bot.ts - Slack bot
src/slack/slack-bot.ts - WeChat bot
src/wechat/wechat-bot.ts - Web chat API
src/api/routes/core-chat-routes.ts
Bridge runtime
- Message bridge
src/bridge/message-bridge.ts - Channel sender
src/bridge/message-sender.interface.ts - Output files
src/bridge/outputs-manager.ts - Bot configuration
src/config.ts
Execution engines
- Engine selection
src/engines/index.ts - Codex executor
src/engines/codex/executor.ts - Kimi executor
src/engines/kimi/executor.ts - Claude executor
src/engines/claude/executor.ts
Core services
- Agent Teams
src/agent-teams/team-store.ts - Peer manager
src/api/peer-manager.ts - Task scheduler
src/scheduler/task-scheduler.ts - Session registry
src/session/session-registry.ts - Document sync
src/sync/doc-sync.ts
Core Console
- Core server
packages/server/src/server.ts - Agent Bus
packages/server/src/bus/message-routes.ts - Memory service
packages/server/src/memory/memory-routes.ts - Skills service
packages/server/src/skills/skill-routes.ts - T5T service
packages/server/src/t5t/t5t-routes.ts - Web Console
packages/web-ui/src/App.tsx - Metabot CLI
packages/cli/src/index.ts
Other components
- User
Connections 29
- User → Feishu adapter: sends message
README.md - User → Telegram bot: sends message
README.md - User → Slack bot: sends message
README.md - User → WeChat bot: sends message
README.md - User → Web chat API: sends request
README.md - Feishu adapter → Message bridge: routes message
src/index.ts - Telegram bot → Message bridge: routes message
- Slack bot → Message bridge: routes message
- WeChat bot → Message bridge: routes message
- Web chat API → Message bridge: accepts chat run
src/api/routes/core-chat-routes.ts - Message bridge → Engine selection: dispatches turn
src/bridge/message-bridge.ts - Engine selection → Codex executor: creates executor
src/engines/index.ts - Engine selection → Kimi executor: creates executor
src/engines/index.ts - Engine selection → Claude executor: creates executor
src/engines/index.ts - Message bridge → Channel sender: sends replies
src/bridge/message-bridge.ts - Message bridge → Output files: manages outputs
src/bridge/message-bridge.ts - Bot configuration → Engine selection: selects engine
src/engines/index.ts - User → Web Console: opens console
README.md - Web Console → Core server: uses Core API
README.md - Core server → Agent Bus: routes bus requests
- Core server → Memory service: serves memory
- Core server → Skills service: serves skills
- Core server → T5T service: serves T5T
- User → Metabot CLI: runs commands
README.md - Message bridge → Agent Teams: supports teamwork
src/bridge/message-bridge.ts - Message bridge → Peer manager: forwards peer tasks
- Message bridge → Task scheduler: schedules tasks
- Message bridge → Session registry: tracks sessions
src/bridge/message-bridge.ts - Message bridge → Document sync: syncs documents
src/bridge/message-bridge.ts