botmuxでMessengerからAIエージェントを制御する
よくあるシナリオを想像してみてください。Claude CodeやCodexで大規模なリファクタリングを開始し、席を離れてお茶を飲んでいるか、帰宅したところ。5分後、CLIがフリーズし、ファイルの削除確認を待っている。あなたの目の前にはスマートフォンだけがあり、プロセスは停止したままです。
コンソールAIアシスタントを активно活用している開発者deepcoldyが、botmuxユーティリティを作成しました。Feishu Messenger（中国外ではLarkとして知られています）を、2ダース以上のコンソールエージェント向けコントロールパネルに変えます。
プロジェクトの核となるアイデア
チャットにAIを統合するほとんどのプラットフォームは、複雑なアプローチを取っています。開発者は必要なモデルのSDKを手に取り、その上にラッパーを構築し、関数呼び出し、メモリ、ファイル処理を再実装します。結果は、実質的なコンソールエージェントの機能を削ぎ落としたものになります。
botmuxは異なるアプローチを取ります。このツールはAIエージェントになろうともせず、独自のコードでコンテキストを管理しようともしません。その代わり、バックグラウンドサービスがサーバーまたはワークステーション上でフル機能のコンソールユーティリティプロセスを起動します。チャット内の新しいトピックやダイアログごとに отдельныеセッションが作成され、出力はインタラクティブカードとしてMessengerにストリーミングされます。
このアーキテクチャには素晴らしい利点があります。Claude Code、Codex、Gemini CLI、またはCursorの開発者が新しいコマンドやMCPサーバーサポートを含むアップデートをリリースしても、botmuxを書き直す必要はありません。元のコンソールアプリケーションの全機能を使用して作業を続けることができます。
4つの興味深い機能
以下では、チャット内でのエージェントとの連携構造について詳しく説明します。
ストリーミングカードとコントロール引継ぎ
CLI出力はMessengerメッセージに直接ストリーミングされます。更新されるテキストを確認し、カードボタンを通じてプロセスを制御できます。ターミナルスクリーンショットの表示、長いログの折りたたみ、フリーズしたセッションの再起動など、すべて利用可能です。
インタラクティブボタンでは不十分な場合、botmuxはWebターミナルリンクを提供します。スマートフォンから直接作業でき、画面にはEsc、Ctrl+C、ナビゲーション矢印ボタンが表示された специальнаяキーボードが表示されます。
マルチモデルチームワーク
1つのグループチャットに、異なるコンソールユーティリティに接続された複数のボットを追加できます。例えば、1つのボットをClaude Codeに、別のボットをCodexに接続します。
@でボットをメンションすると、メッセージはその特定のエージェントに送られます。これはコードの相互レビューに便利です。2つの異なるモデルに同じプルリクエストを分析を依頼すると、議論スレッド内で互いに議論し始めます。
デバイス間のセッション移行
慣れ親しんだtmuxでローカルにセッションを開始したとします。チャットで/adoptコマンドを使用すると、そのセッション的控制をスマートフォン上で直接引き継ぐことができます。
タスクの議論が長引いてチーム全体で共有する必要がある場合、/relayコマンドは蓄積されたメモリとコンテキスト вместе с全过程を共有グループチャットに移行します。
自動化と外部トリガー
このユーティリティはスケジューリングとWebhookをサポートしています。平易な言語でタスクを記述することで、定期的なアラート解析やスケジュールされたレポート生成を設定できます。外部システムは標準的なHTTPリクエストを通じてエージェントをトリガーできます。
内部動作の仕組み
このプロジェクトはTypeScriptで記述され、Node.jsバージョン22以上で動作します。異なるCLIをサポートするために、内部的にアダプターアーキテクチャを使用しています：
claude-codecodexgeminicursoropencodecopilot
ローカルユーティリティはプロセス分離で実行されます。ワークステーションにいる場合は、実行中のエージェントにいつでも直接tmux attachで接続できます。
インストールと初期設定は最小限に简化されています：
npm install -g botmux
botmux setup
botmux start
インタラクティブなウィザードであるbotmux setupが、QRコード経由でFeishuアカウントのバインドを手伝い、エンタープライズダッシュボードでアプリ権限を自動構成し、基本設定を開始します。
試してみる価値はあるか
このプロジェクトはGitHubで900近いスターを獲得しており、理由のないことではありません。コードは丁寧に構造化されており、別のSDKを書くのではなく本物のCLIを使用するというアイデアは賢明に聞こえます。
このユーティリティの主な欠点は、Feishu/Lark Messengerとの密な結合です。あなたのチームがSlackやTelegramを使っている場合、既成のツールを使用することはできません。独自のブリッジを書くか、リポジトリからアダプターを移植する必要があります。
それでも、Larkを使いこなしていてターミナルAIエージェント активно活用しているなら、botmuxはモニターの前に常に座っている必要からあなたを解放します。GitHubでプロジェクトリポジトリをチェックして、サポートされているアダプターのリストを確認するか、アーキテクチャソリューションをご覧ください。
関連プロジェクト