スキル

AI Maestro:マルチエージェントオーケストレーションダッシュボードを安全に使い始めるガイド

複数の AI コーディングエージェント(Claude Code、Codex、Grok Build など)のセッションを 1 つの Web ダッシュボードで一元管理したい開発者に適しています。利用前の最重要ポイントは、アプリケーション層の認証がないため信頼できるネットワーク内でのみ実行し、ポート 23000 を信頼できないネットワークに公開してはならないことです。

公式ソース · AI Maestro (GitHub 仓库)

インストール

curl -fsSL aimaestro.sh | bash

こんな人に向いている

  • Claude Code、Codex、Grok Build など複数の AI コーディングエージェントを同時に使う開発者で、複数のターミナルを行き来するのではなく、1 つの Web ダッシュボードでこれらのエージェントセッションを一元管理したい人。
  • エージェントにメモリ検索、コードグラフ照会、エージェント間メッセージ通信などの拡張機能を持たせたいユーザー。
  • 利用前提:ローカルマシンでシェルコマンド 1 つでインストールを完了できる必要があります。このアプリ自体にはアプリケーション層の認証がないため、信頼できるネットワーク(Tailscale の内部ネットワークなど)内でのみ使用しなければならず、ポート 23000 を信頼できないネットワークに公開してはいけません。ネットワーク境界を保証できない場合、またはこのセキュリティモデルを受け入れられない場合は、使用に向いていません。
  • 公式の情報では、対応 OS の最低要件やエージェントのバージョン要件は明記されておらず、これらの情報は現時点で不明です。

3 分で最初の試用を完了する

推奨されるメインの経路は、公式ドキュメントが示すリモートシェルによるインストールです。

curl -fsSL aimaestro.sh | bash
  1. 前提:シェルを実行できるマシンがあり、自分が管理できる信頼できるネットワーク内にあること。
  2. インストール:ターミナルで上記のコマンドを実行します。公式の remote-install スクリプトが実行されます。注意:これはネットワークからスクリプトをダウンロードして実行する操作です。インストール前にその提供元を信頼できるか確認してください。
  3. インストール後:起動すると Web ベースのターミナルインターフェースが提供され、tmux を通じて各 AI エージェントのセッションを管理します(xterm.js ターミナル + node-pty + WebSocket によるストリーミング出力)。
  4. 最初の試用には低リスクのタスクを選ぶことをおすすめします:ダッシュボードで既存のエージェントセッションを開き、読み取り専用の分析を 1 回行わせます。たとえば、あるコードファイルの構造を要約させるなどです。特定のエージェントがどのタスクに対応できるかはそのエージェント次第であり、公式の情報では列挙されていません。
  5. 成功のサイン:ブラウザでそのエージェントのターミナルセッションのリアルタイム出力が見え、エージェントが分析結果を返すこと。ダッシュボードで複数のエージェントセッションを同時に表示できれば、オーケストレーションが機能していることの証明にもなります。

公式には、1 つのダッシュボードから複数のエージェントを管理できるとも記載されていますが、他のインストール方法は示されておらず、本ガイドでは上記の公式経路のみを残しています。

使用例

ケース 1:複数のエージェントセッションを一括で確認する。 シナリオ:Claude Code と別のエージェントを同時に実行していて、同じ画面で両方を確認したい。 やり方:インストールして起動したら、ブラウザでダッシュボードを開き、管理したいエージェントセッションを接続します(公式の説明では tmux を通じてセッションを管理するとされています)。期待できる結果:1 つの Web インターフェースで、xterm.js ターミナルを通じて各セッションのリアルタイム出力を確認できます。

ケース 2:エージェントに読み取り専用のコード分析を 1 回行わせる。 シナリオ:オーケストレーション環境が使えることを確認したいが、エージェントにはファイルを一切変更させたくない。 やり方:ダッシュボードでいずれかのエージェントに指示を出します。たとえば「src ディレクトリ内のあるファイルの構造を分析して要約して」など。使用される機能:ダッシュボードのターミナルセッションそのもの。メモリ検索やコードグラフ照会が呼び出されるかどうかは、そのエージェントに読み込まれているスキル次第であり、公式の情報ではデフォルトの読み込み状況は明記されていません。期待できる結果:エージェントがターミナルに分析テキストを出力します。ファイル変更を伴う操作がなければ、取り消し可能な観察型のタスクに該当します。

使用上の境界

  • ネットワーク:アプリはデフォルトで 0.0.0.0 にバインドされ、アプリケーション層の認証はありません。セキュリティモデルは「ネットワークが信頼境界」というもので、公式では Tailscale などのネットワーク境界と併用することが求められ、ポート 23000 を信頼できないネットワークに公開してはいけません。
  • 副作用と確認ポイント:インストールではリモートスクリプトが実行されます。エージェントセッションはコマンドを実行したりファイルにアクセスしたりする可能性があり、具体的な挙動は接続したエージェント次第です。このアプリ自体がエージェントの操作に追加の制限を課しているかについて公式の情報はなく、不明な情報を「リスクなし」と扱ってはいけません。
  • 実行環境:tmux と WebSocket に対応したブラウザが必要です。OS 要件は公式の情報では明記されていません。
  • 公式が明示している制限:アプリケーションレベルの認証がないことは設計上の決定であり、設定可能なオプションであることを示す情報はありません。
  • 未確認事項:対応するテキスト/エージェントの言語範囲、対応クライアントの完全なリスト、アップグレードとアンインストールの方法については、いずれも公式の情報がありません。