botmux：從 README 拆解功能、限制與採用條件
將飛書/Lark 與 AI 編碼 CLI、Claude Code、Codex、Gemini、OpenCode 連接起來，每個 DM、群組或主題都會產生自己的直播 CLI 會話。
秒懂
- 它是什麼？
- Bridge Feishu/Lark to AI coding CLIs, Claude Code, Codex, Gemini, OpenCode every DM, group or topic spawns its own live-streaming CLI session.。本文整理 deepcoldy/botmux README 的使用入口、環境條件、功能邊界與專案專屬核驗方式。
- 適合誰用？
- botmux 適合需要 Bridge Feishu/Lark to AI coding CLIs, Claude Code, Codex, Gemini, OpenCode every DM, group or topic spawns its own live-streaming CLI session. 所描述能力，且能管理其環境與設定的使用者；不適合把 README 範例或未說明行為當成正式保證。先執行：在 deepcoldy/botmux 使用 Node 22 執行 botmux setup，再檢查 Lark 權限、botmux config、CLI session 與即時卡片串流。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 1 天前。
- 用什麼語言寫的？
- 主要是 TypeScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
botmux：它連接了什麼（1）
botmux 將自己定位為 Lark（飛書）與 AI 編碼命令列工具之間的橋接器。根據 README 的描述，一個守護行程監聽 Lark 訊息，為每個新工作階段啟動一個隔離的行程，將 AI 編碼 CLI 或代理的輸出作為即時 Lark 卡片串流推送回來，並提供互動式 Web 終端。README 強調它不會重新實作代理能力，而是直接連接您已經在使用的工具。
在 deepcoldy/botmux 使用 Node 22 執行 botmux setup，再檢查 Lark 權限、botmux config、CLI session 與即時卡片串流。
botmux：執行前提與設定（2）
README 列出的要求是 Node 22 或更高版本，並透過 npm 安裝 botmux。其設定流程圍繞 `botmux setup` 命令展開，該命令透過一次 Lark 二維碼掃描建立應用程式、設定權限並發佈版本。使用 `--no-open-platform-auto` 旗標會跳過權限和發佈自動化，以便手動完成。之後執行 `botmux start` 啟動守護行程，可選啟用 `botmux autostart enable` 以便在啟動時自動執行。
botmux：核心情境（3）
README 描述了幾個核心情境。即時串流卡片顯示每個回合的即時更新卡片，終端螢幕以截圖形式原樣顯示，並帶有顯示/隱藏、捲動、重新啟動、關閉或接管工作階段等控制。多機器人協作支援在一個群組中透過 @ 提及路由到多個機器人，使不同的 CLI（例如 Claude Code 和 Codex）能夠獨立審查同一個合併請求。多主題編排允許編排者產生主題，並為每個機器人啟動隔離的工作階段以執行管線，進度顯示在 Lark 任務面板中。
botmux：工作階段與存取控制（4）
README 還描述了工作階段接管和轉發：如果您在本地 tmux 中執行，則可以透過 `/adopt` 從手機接管工作階段；`/relay` 將整個工作階段（同一行程、同一記憶體）移動到團隊群組。Web 終端不僅可以檢視輸出，還可以從瀏覽器或手機直接驅動 CLI，並在行動端提供浮動快捷列（Esc、Ctrl+C、方向鍵）。README 還提到了排定任務、外部 Webhook 和任務觸發 API，以及待命模式和語音摘要。
botmux：支援的 CLI 和代理（5）
README 表示支援 20 多個介面卡，涵蓋本地 CLI（透過 `tmux attach` 存取的隔離行程）和 API/雲端代理（如 Mira 和 riff）。它列出了一些具代表性的 CLI：`claude-code`、`codex`、`gemini`、`cursor`、`opencode`、`antigravity`、`copilot`、`grok`、`kimi`、`kiro-cli`、`aiden`、`coco` (TRAE)、`hermes`、`mira` 和 `riff`。README 指出，在 `src/adapters/cli/registry.ts` 中的目前完整 `cliId` 集合是權威的，而不是 README 中的清單。
botmux：設計理念（6）
README 闡述的設計理念是直接橋接完整的 CLI 行程，而不是透過 Agent SDK 重新實作能力。它聲稱這樣可以利用 CLI 內建的鉤子、記憶、計畫模式、MCP 和 `/` 命令，並且 CLI 升級通常能直接使 botmux 受益，除非介面或恢復語義發生變化需要介面卡跟上。README 還包含一個比較表，用於對比 botmux 與基於 Agent SDK 的方法在整合邊界上的差異，並明確聲明它不聲稱其他方法「必然缺乏」某些功能。
botmux：文件、社群與授權（7）
README 指向位於 https://deepcoldy.github.io/botmux/en/ 的完整文件，以及一個帶插圖和影片的展示，一個包含常見問題解答和常見陷阱的 FAQ 部分，以及一個包含加入群組二維碼的社群頁面。它歡迎為新增介面卡而提交 issue 和 PR，並指向 CLI 介面卡文件。README 還提到授權是 MIT，這與倉庫元資料一致。
第 1 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 2 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 3 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 4 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 5 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 6 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 7 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 8 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 9 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 10 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 11 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 12 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 13 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 14 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
第 15 次檢查仍針對 botmux：執行上述命令後，核對指定檔案、輸出格式、服務回應與退出碼；若結果不同，先對照 README 的版本、平台和設定鍵，再判斷是環境缺件還是專案行為。
編輯結論
botmux 適合需要 Bridge Feishu/Lark to AI coding CLIs, Claude Code, Codex, Gemini, OpenCode every DM, group or topic spawns its own live-streaming CLI session. 所描述能力，且能管理其環境與設定的使用者；不適合把 README 範例或未說明行為當成正式保證。先執行：在 deepcoldy/botmux 使用 Node 22 執行 botmux setup，再檢查 Lark 權限、botmux config、CLI session 與即時卡片串流。，再依實際產物決定是否納入既有流程。
社群筆記