botmux：Lark/Feishu メッセージを AI コーディング CLI に橋渡しする

接続するもの

botmux は、Lark（Feishu）と AI コーディングコマンドラインツールの間のブリッジとして説明されています。README によると、デーモンが Lark メッセージを監視し、新しいセッションごとに分離されたプロセスを起動し、AI コーディング CLI またはエージェントの出力をライブの Lark カードとしてストリーミングし、インタラクティブな Web ターミナルを提供します。README は、エージェント機能を再実装するのではなく、すでに使用しているツールを直接橋渡しすることを強調しています。

前提条件とセットアップ

README は、Node 22 以上を要件として挙げ、npm でのインストールを説明しています。セットアップフローは `botmux setup` コマンドを中心としており、1 回の Lark QR スキャンでアプリを作成し、権限を設定し、バージョンを公開します。`--no-open-platform-auto` フラグを使用すると、権限と公開の自動化をスキップし、手動で完了できます。その後、`botmux start` でデーモンを実行し、`botmux autostart enable` で起動時に自動起動することもできます。

中核となるシナリオ

README はいくつかの中核シナリオを説明しています。ライブストリーミングカードは、ターンごとにライブ更新されるカードを 1 枚表示し、ターミナル画面をスクリーンショットとしてそのまま中継し、出力の表示/非表示、スクロール、再起動、終了、セッションの引き継ぎなどの制御を提供します。マルチボットコラボレーションは、1 つのグループ内の @ メンションを複数のボットにルーティングし、Claude Code や Codex などの異なる CLI が同じマージリクエストを独立してレビューできるようにします。マルチトピックオーケストレーションでは、オーケストレーターがグループ内にトピックを作成し、ボットごとに分離されたセッションを起動してパイプラインを実行し、Lark タスクボードに進行状況を表示します。

セッションの処理とアクセス

README はセッションの引き継ぎとリレーについても説明しています。ローカルの tmux で実行中の場合、`/adopt` でスマートフォンから引き継ぎ、`/relay` でセッション全体（同じプロセス、同じメモリ）をチームグループに移動できます。インタラクティブな Web ターミナルでは、ブラウザやスマートフォンから直接 CLI を操作でき、モバイルでは Esc、Ctrl+C、矢印キーなどのフローティングショートカットバーが提供されます。スケジュールされたタスク、外部 Webhook、タスクトリガー API に加えて、オンコールモードと音声サマリーも言及されています。

サポートされている CLI とエージェント

README は、`tmux attach` で到達可能な分離プロセスであるローカル CLI と、Mira や riff などの API またはクラウドエージェントにわたる 20 以上のアダプタをサポートしていると述べています。代表的な CLI として、`claude-code`、`codex`、`gemini`、`cursor`、`opencode`、`antigravity`、`copilot`、`grok`、`kimi`、`kiro-cli`、`aiden`、`coco` (TRAE)、`hermes`、`mira`、`riff` が挙げられています。README は、README のリスト自体ではなく、`src/adapters/cli/registry.ts` にある現在の完全な `cliId` セットが権威であると指摘しています。

設計思想

README が述べる設計思想は、Agent SDK を通じて機能を再実装するのではなく、完全な CLI プロセスを直接橋渡しすることです。これにより、CLI に組み込まれたフック、メモリ、プランモード、MCP、`/` コマンドが維持され、CLI のアップグレードは、インターフェースや再開セマンティクスが変更されてアダプタが追従する必要がある場合を除き、ほとんどの場合 botmux に直接利益をもたらすと主張しています。README には、検証可能な統合境界に限定した botmux と Agent SDK ベースのアプローチの比較表が含まれており、他のアプローチが「必然的に欠けている」とは主張していないと明示しています。

ドキュメント、コミュニティ、ライセンス

README は、https://deepcoldy.github.io/botmux/en/ の完全なドキュメント、イラストとビデオ付きのショーケース、一般的な落とし穴をカバーする FAQ セクション、グループに参加するための QR コードがあるコミュニティページを指しています。アダプタの追加などの貢献のために issue と PR を歓迎し、CLI アダプタのドキュメントにリンクしています。README はライセンスが MIT であることも述べており、これはリポジトリメタデータと一致しています。実施記録には対象版と入力条件を残し、成功した結果だけでなく失敗した場合の出力も保存します。設定を変更した前後で同じ確認を繰り返せるようにし、READMEに書かれた機能と自分の環境で確認できた事実を分けます。採用判断では、導入できたかだけでなく、更新、障害、切り戻し、権限、ライセンスを同じ担当者が追跡できるかを確かめます。\n\n導入前に確認したいのは、どの CLI をどの作業ディレクトリで動かすかです。`bots.json` には非機密のメタデータと秘密ファイルのパスだけを置き、ebsd のトークンや AK/SK は実行アカウントが所有する 0600 の通常ファイルに分離します。Linux で sandbox を有効にする場合は bubblewrap が必要で、隔離の確立に失敗すると起動を拒否します。会話開始後は CLI 選択が固定されるため、wrapperCli や model が必要な構成は bot の既定値として設計する必要があります。

編集部の結論

README はプロジェクトが MIT ライセンスであると述べており、ライセンステキストは使用、複製、変更、結合、公開、配布、サブライセンス、販売の権利を明示的に許可し、ソフトウェアは現状のまま保証なしで提供されます。README はセキュリティアップデート、商用サポート、特定の本番環境での検証については言及しておらず、これらの側面は利用可能な資料では確立されていません。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes