botmux

在飞书里遥控你的 AI 编程 CLI。一条消息启动一个会话，每个会话一个独立 CLI 进程，实时流式回传——手机、电脑、终端三端同步。

📖 文档 · 🚀 快速接入 · ✨ 效果展示 · English

https://github.com/user-attachments/assets/2cd97623-6b92-42ea-a9e9-75c6f5434db6

---

Daemon 监听飞书消息，为每个新会话自动 spawn 一个独立的会话进程，把 AI 编程 CLI / Agent 的输出实时流式回传成飞书卡片，并提供可交互的 Web 终端。它不重造 Agent 能力，而是直接桥接你已经在用的工具（20+ CLI / Agent 适配器，见 支持的 CLI / Agent）。

它解决什么

• Agent 收不到通知、手机控不了 — CLI 跑在开发机上，人在手机上。botmux 把每轮输出推成飞书卡片，随时随地查看 / 追问 / 打断，还能开可写 Web 终端直接操作。
• CLI 不感知飞书上下文 — 把机器人拉进话题群 / oncall 群，@ 一句就在你本机的代码库里开跑；会话可以用 /relay 原样搬到另一个群，上下文一点不丢。
• 单个 Agent 不够用 — 同一个群里放多个不同 CLI 的机器人，@ 谁谁干活，让 Claude Code 和 Codex 一起 review 同一个 MR、各自独立分析、观点不同自动互怼。

5 分钟接入

约 5 分钟：botmux setup 一次飞书扫码就连续建好应用、配全权限、发版（加 --no-open-platform-auto 则只建应用、跳过权限与发版的自动配置，之后需手动完成；手动创建 / 粘贴凭证是 setup 里的另一个选项）。

curl -fsSL https://raw.githubusercontent.com/deepcoldy/botmux/master/install.sh | sh
botmux setup                 # 一次扫码建应用 → 选 CLI → 选工作目录（自动配权限 + 发版）
botmux start                 # 启动 daemon（botmux autostart enable 设开机自启）

botmux 本体是一个自包含单文件二进制，运行时已嵌在里面——装它和跑它都不需要机器上有 Node（你要接的 AI 编程 CLI 自己需要什么另算）。装到 ~/.botmux/bin/botmux（BOTMUX_INSTALL_DIR 可改），按 OS/arch 自动选对应二进制、校验 SHA-256，并把 ~/.botmux/bin 写进你当前 shell 的启动文件（zsh / bash / fish 各写对的那个），开个新终端就能用。

安装过程不编译任何原生模块（不需要 Python / node-gyp / 编译器）：PTY 已经嵌在二进制里。支持 linux / macOS × x64 / arm64（Alpine 等 musl 环境自动选 musl 版）；Windows 请在 WSL2 里安装（daemon 依赖 PTY / tmux / Unix 信号，原生 Windows 跑不了；WSL2 报告为 linux，是完整支持的一等环境）。平台不在列表里、或下下来的二进制在本机跑不起来，安装会明确报错并保留原有版本，而不是装上一个起不来的命令。

正式版 macOS CLI 使用稳定的 Apple Developer ID 签名。升级替换二进制后，macOS 的文件与 App 数据访问授权仍绑定同一代码身份，不会因为版本哈希变化而把 botmux 当成一个新程序；canary / beta / rc 等预览版仍使用 ad-hoc 签名。

升级：一律重跑上面那条 curl 命令（npm / pnpm 全局安装也用它，原地替换、不会重复往启动文件里追加 PATH），装完开个新终端跑 botmux restart；≥3.18 的二进制安装上 botmux upgrade 与其等价。装指定版本（含回滚）：curl -fsSL https://raw.githubusercontent.com/deepcoldy/botmux/master/install.sh | BOTMUX_VERSION=v3.18.8 sh（变量必须在管道右侧的 sh 前面）。⚠️ v3.18.0 之前的老版本不要用 npm 升级——跨「Node 源码 → 二进制」形态边界会让 daemon 重启失败。

已经在用 Node 生态？也可以走 npm（同一个二进制）

npm install -g botmux        # 需要 Node >= 22 装包本身

npm 包内带的是同一个自包含二进制（按 os/arch 只装匹配的那一个）。包的 bin 指向随包发布的 sh 启动器，由包管理器自己链到 PATH——npm / pnpm / bun 三种装法都不依赖生命周期脚本（pnpm 10/11 与 bun 默认不跑依赖的 postinstall，早期版本因此装完没有任何 botmux 命令）。postinstall 仍会把 ~/.botmux/bin/botmux 指向同一个二进制并写 PATH。所以装完始终只有一个 botmux 版本（两个入口都 exec 同一个二进制），不再出现「装了两个 Node 版本、各自带一份全局 botmux 互相打架 / 不知道更新了哪个」。

区别只在谁来装：npm 路径需要 Node ≥ 22 才能执行安装本身，curl 路径全程不碰 Node；无论哪种装法，升级都重跑 curl（v3.18.0 之前的老版本用 npm 跨形态升级会让 daemon 起不回来）。跑起来之后两者完全一致——同样的二进制、同样的命令。

然后私聊机器人、或 botmux dashboard 拉个群，直接开聊。完整步骤（含 Lark 国际版、--no-open-platform-auto 后手动配置权限 / 发版、排查）见 5 分钟快速接入。

核心场景