How deepcoldy/botmux works
botmux bridges Feishu/Lark conversations to existing AI coding CLIs and agents. Its principal flow is a user message entering the daemon, becoming an isolated session running through a CLI adapter and backend, then returning as a streaming Feishu card; users can also operate sessions through a web terminal. The map includes documented scheduling, webhook, multi-bot, workflow, plugin, and dashboard capabilities. Relationships beyond the sampled excerpts are based on README statements; unsampled implementation details are not inferred.
Main entry points: session-manager.ts Session manager · runtime.ts CLI runtime · types.ts Session backends · http.ts Dashboard API
Components 25
Messaging and entry
- Daemon
src/daemon.ts - Lark transport
src/im/lark/client.ts - Card handling
src/im/lark/card-handler.ts
Sessions and agents
- Bot registry
src/bot-registry.ts - Session manager
src/core/session-manager.ts - CLI adapters
src/adapters/cli/registry.ts - CLI runtime
src/adapters/cli/runtime.ts - Session backends
src/adapters/backend/types.ts - Mojo backend
src/adapters/backend/mojo-types.ts - Riff backend
src/adapters/backend/riff-backend.ts - Read isolation
src/adapters/cli/read-isolation.ts - Session state
src/core/session-manager.ts
Control and automation
- Scheduler
src/core/scheduler.ts - Webhook triggers
src/dashboard/webhook-routes.ts
User interfaces
- Web terminal
src/core/terminal-proxy.ts - Dashboard API
src/dashboard/http.ts - Dashboard UI
src/dashboard/web/app.tsx - Agent workbench
src/dashboard/web/agent-workbench-page.tsx
Workflows and extensions
- V3 workflows
src/im/lark/v3-progress-card-manager.ts - Plugin services
src/core/plugins/service-manager.ts - Skill prompts
src/skills/prompt-fragments.ts
Other components
- Feishu user
- Coding CLI / agent
- Browser user
- External trigger
Connections 27
- Feishu user → Lark transport: sends message
README.md - Lark transport → Daemon: delivers events
README.md - Daemon → Session manager: starts sessions
README.md - Session manager → Bot registry: resolves bot
src/core/session-manager.ts - Session manager → CLI adapters: selects adapter
src/core/session-manager.ts - CLI adapters → CLI runtime: configures CLI
src/adapters/cli/registry.ts - CLI runtime → Session backends: uses backend
- Session backends → Mojo backend: supports
- Session backends → Riff backend: supports
- Session manager → Read isolation: applies isolation
src/core/session-manager.ts - Session manager → Session state: manages state
src/core/session-manager.ts - CLI runtime → Coding CLI / agent: runs agent
README.md - Session manager → Card handling: streams output
README.md - Card handling → Lark transport: updates cards
README.md - Browser user → Web terminal: operates session
README.md - Web terminal → Session manager: controls session
README.md - Browser user → Dashboard UI: uses dashboard
README.md - Dashboard UI → Dashboard API: calls API
- Dashboard API → Session manager: manages sessions
- Browser user → Agent workbench: uses workbench
README.md - Scheduler → Session manager: starts scheduled turns
README.md - External trigger → Webhook triggers: triggers tasks
README.md - Webhook triggers → Session manager: dispatches trigger
src/dashboard/webhook-routes.ts - Feishu user → V3 workflows: starts orchestration
README.md - V3 workflows → Card handling: reports progress
src/im/lark/v3-progress-card-manager.ts - Dashboard API → Plugin services: configures services
- Session manager → Skill prompts: uses prompt fragments