botmux – 从飞书远程控制您的 AI 编码 CLI

它是什么

• 一个自包含的二进制文件（无需 Node.js），运行一个守护进程，监听飞书（Lark）消息。
• 对于每个新的聊天会话，它会生成一个独立的 CLI/代理进程（例如 Claude-Code、Codex、Gemini 等），并将进程输出以实时更新的卡片形式流式返回聊天。
• 提供交互式 Web 终端，您可以从浏览器或手机直接输入到 CLI。

为什么重要

• 开发人员通常在本地运行强大的 AI 编码代理，但无法从移动设备监控或控制它们。botmux 弥补了这一差距：在飞书中发送一条消息即可启动会话，代理的输出立即以卡片形式出现，您可以通过 Web 终端继续对话、中断或接管。
• 它支持 20+ 适配器，适用于流行的 AI 编码 CLI 和远程代理，因此您无需重写或重新实现任何代理逻辑——botmux 仅转发 stdin/stdout。

主要功能（根据 README 描述）

功能	您获得的内容
一键启动会话	在飞书群组中 @bot <提示> 会生成一个新的 CLI 进程；每个会话都是隔离的。
实时流式卡片	每一行输出都会以刷新后的卡片形式发送回来，并提供隐藏/显示、滚动、重启或关闭会话的控件。
多机器人协作	多个机器人可以共存于同一群组；@bot-name 将请求路由到选定的 CLI/代理（例如 Claude-Code 与 Codex）。
Web 终端	基于浏览器的终端（支持移动端）可让您直接输入、发送 Ctrl-C、导航等，直接进入正在运行的进程。
会话交接	像 /adopt 这样的命令可让另一个用户接管正在运行的 tmux 会话；/relay 将整个会话移动到另一个群组。
调度与 Webhooks	自然语言命令创建定期任务；外部系统可通过 webhook 或 API 触发运行。
值班模式与语音摘要	在值班群组中，任何人都可以 @ 机器人运行诊断；可选的 TTS 添加音频摘要按钮。
零注入模式	可选地抑制 botmux 添加的提示，使 CLI 只看到原始用户消息，适用于“主导机器人”工作流。
反馈收集	最终答案卡片可包含可配置的点赞/进度/负面按钮，并本地存储。
跨平台安装	单个二进制文件适用于 Linux/macOS（x64 和 arm64）以及通过 WSL2 的 Windows；也可以通过 npm install -g botmux 安装（npm 包仅包含相同的二进制文件）。
可扩展适配器	bots.json 定义要运行的 CLI、工作目录、环境变量、沙箱等。适配器涵盖本地 CLI、云代理（Mira、riff）和通用远程运行器协议。

典型工作流程

1. 使用一行 curl … | sh（或通过 npm）安装二进制文件。
2. 运行 botmux setup – 扫描二维码创建飞书应用，选择要暴露的 CLI，并设置工作目录。
3. 启动守护进程：botmux start（或启用自动启动）。
4. 在飞书聊天中，@bot <您的提示> 启动会话；机器人回复一张卡片，随着 CLI 输出而更新。
5. 使用卡片上的 Web 终端链接直接交互，或发出 /adopt、/relay、/cli <id> 等命令来管理会话。

适用人群

• 已经在本地使用 AI 编码助手并希望获得移动/远程可见性的开发人员。
• 需要在同一聊天中使用多个代理的团队（例如，由 Claude-Code 和 Codex 进行代码审查）。
• 希望安排 AI 驱动的诊断或通过 webhooks 暴露它们的运维团队。

许可证与社区

• 根据 MIT 许可证开源。
• 完整文档位于 https://deepcoldy.github.io/botmux/，并提供社区聊天支持。

---

以上所有细节均直接取自仓库的 README；未推断任何额外功能。