Botmux bridges IM platforms like Feishu with AI coding CLIs, enabling single-topic, persistent CLI sessions with live streaming. It acts as a daemon, automatically launching dedicated CLI processes for new topics and providing real-time interactive cards and web terminals. This streamlines AI-assisted development workflows by integrating them directly into chat environments, leveraging existing CLI capabilities without reimplementation.

How It Works

Botmux directly bridges existing AI programming CLIs (e.g., Claude Code, Codex, Gemini) rather than reimplementing agent logic. This "standing on the shoulders of giants" approach ensures automatic benefit from CLI upgrades and avoids duplicating features like memory or tool-calling. It offers a unified interface for multiple CLIs, enhanced with real-time streaming cards, interactive web terminals, and robust session management via tmux.

Quick Start & Requirements

• Install: npm install -g botmux
• Setup: botmux setup (interactive, ~5 mins, requires Node.js >= 20, AI CLIs in PATH, Feishu QR scans).
• Run: botmux start
• Prerequisites: Node.js >= 20, AI coding CLIs (Claude Code, Codex, Cursor, Gemini, etc.) in PATH, tmux >= 3.x (optional for persistence), CJK fonts (manual install may be needed on some Linux).
• Docs: Full Documentation

Highlighted Details

• Real-time Feishu Cards: Live terminal output rendering, status indicators, and interactive controls (open terminal, restart, close).
• Interactive Web Terminal: Accessible via link, with mobile-friendly shortcuts.
• Multi-Robot/Topic Collaboration: Orchestrates complex workflows, task decomposition, parallel execution, and shared progress boards within Feishu.
• Tmux Persistence: CLI sessions survive daemon restarts, automatically re-attaching on new messages.
• Scheduled Tasks: Supports natural language, duration, and cron scheduling within topics.

Maintenance & Community

Contribution guidelines available in CONTRIBUTING.md. No explicit community links (Discord/Slack) or roadmap details are provided in the README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive for commercial use.

Limitations & Caveats

CJK font installation may require manual steps on certain Linux distributions. Specific AI CLI versions (e.g., CoCo >= 0.120.32) are recommended for optimal behavior. Feishu open platform setup automation may occasionally require manual fallback.