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)、汎用リモートランナープロトコルをカバーします。

典型的なワークフロー

  1. ワンライナー curl … | sh(または npm)でバイナリをインストールします。
  2. botmux setup を実行 – QR コードをスキャンして Feishu アプリを作成し、公開する CLI を選択し、作業ディレクトリを設定します。
  3. デーモンを起動:botmux start(または自動起動を有効化)。
  4. Feishu チャットで @bot <プロンプト> を送信するとセッションが開始され、ボットは CLI の出力に応じて更新されるカードで応答します。
  5. カードの Web ターミナルリンクを使用して直接操作するか、/adopt、/relay、/cli <id> などのコマンドでセッションを管理します。

対象ユーザー

  • ローカルで AI コーディングアシスタントを使用しており、モバイル/リモートでの可視性を求める開発者。
  • 同じチャットで複数のエージェントを使用するチーム(例:Claude-Code と Codex によるコードレビュー)。
  • AI 駆動の診断をスケジュールしたり、webhook で公開したい運用チーム。

ライセンスとコミュニティ

  • MIT ライセンスでオープンソース。
  • 完全なドキュメントは https://deepcoldy.github.io/botmux/ にあり、サポート用のコミュニティチャットもあります。

上記の詳細はすべてリポジトリの README から直接取得したものであり、追加の機能は推測されていません。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト