deepcoldy/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
botmux – Feishu から AI コーディング CLI をリモート制御
概要
- Node.js 不要の自己完結型バイナリで、Feishu(Lark)メッセージをリッスンするデーモンを実行します。
- 新しいチャットセッションごとに独立した CLI/エージェントプロセス(例:Claude-Code、Codex、Gemini など)を生成し、プロセス出力をライブ更新カードとしてチャットにストリーミングします。
- ブラウザやスマホから CLI に直接入力できるインタラクティブな Web ターミナルを提供します。
重要性
- 開発者は強力な AI コーディングエージェントをローカルで実行していますが、モバイルデバイスから監視・制御する方法がありません。botmux はそのギャップを埋めます:Feishu で 1 つのメッセージを送信するとセッションが開始され、エージェントの出力が即座にカードとして表示され、Web ターミナルで会話の継続、中断、引き継ぎが可能です。
- 人気の AI コーディング CLI およびリモートエージェント向けの 20 以上のアダプター に対応しているため、エージェントロジックを書き直す必要はありません。botmux は stdin/stdout を転送するだけです。
主な機能(README の説明に基づく)
| 機能 | 内容 |
|---|---|
| ワンクリックセッション開始 | Feishu グループで @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)、汎用リモートランナープロトコルをカバーします。 |
典型的なワークフロー
- ワンライナー
curl … | sh(または npm)でバイナリをインストールします。 botmux setupを実行 – QR コードをスキャンして Feishu アプリを作成し、公開する CLI を選択し、作業ディレクトリを設定します。- デーモンを起動:
botmux start(または自動起動を有効化)。 - Feishu チャットで
@bot <プロンプト>を送信するとセッションが開始され、ボットは CLI の出力に応じて更新されるカードで応答します。 - カードの Web ターミナルリンクを使用して直接操作するか、
/adopt、/relay、/cli <id>などのコマンドでセッションを管理します。
対象ユーザー
- ローカルで AI コーディングアシスタントを使用しており、モバイル/リモートでの可視性を求める開発者。
- 同じチャットで複数のエージェントを使用するチーム(例:Claude-Code と Codex によるコードレビュー)。
- AI 駆動の診断をスケジュールしたり、webhook で公開したい運用チーム。
ライセンスとコミュニティ
- MIT ライセンスでオープンソース。
- 完全なドキュメントは https://deepcoldy.github.io/botmux/ にあり、サポート用のコミュニティチャットもあります。
上記の詳細はすべてリポジトリの README から直接取得したものであり、追加の機能は推測されていません。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト