Agent Tree:Claude Code サブエージェントを箱のツリーで見る
サブエージェントを箱で描くサイドペイン。メインセッション、アドバイザー、セッションログも表示します。
権限
- ツール呼び出しを傍受Claude が行うすべてのツール呼び出しを参照でき(tool.call / tool.check)、ブロックや変更も可能です。
- プロンプトを読み取る入力内容と会話のトランスクリプトを参照できます(prompt.* / session.append / session.messages)。
- UI を変更Claude Code の画面に描画します。バンド、ペイン、ステータス表示、トーストなど(ui.render / $.ui.*)。
- コマンド・ツールを追加あなたや Claude が呼び出せる新しいスラッシュコマンドやツールを登録します($.command.register / $.tool.register)。
- 検証バージョン
- v2.1.310
- 最終検証日
- 必要バージョン
- Claude Code ≥ 2.1.287
- 表示先
- ペイン、ステータス
このModでできること
Agent Tree は Mike Pollow, Digitalroots(MikeGT4)によるコミュニティ製の mod です。Claude Code のサブエージェントを、サイドペインに箱のツリーとして描きます。一番上はメインセッションで、モデル、effort レベル、コンテキスト使用量、ラウンド数が出ます。その下にサブエージェントごとの箱があり、種類、モデル、説明、最後のツール、状態行、タイムラインバーを表示します。最後の箱はメインセッションへ戻る経路で、返ってきた回答の数を示します。
ツリーの横のアドバイザー列には、アドバイザーモデルが設定されているか、メインセッションとサブエージェントのどちらから何回相談されたか、最後の時刻が出ます。いちばん下のセッションログには、ラウンド、エージェントの開始と終了、アドバイザー呼び出し、あなた自身の選択が並びます。エージェントが多いときは省スペースの行表示に切り替わり、多数のエージェントを含むワークフローは 1 つの箱にまとめられます。
ペインは操作画面でもあります。エージェントの種類をクリックすると、タスク、最近のツール、最新の回答が見られ、そこから停止もできます。新しいサブエージェントや実行中の 1 つにモデルファミリーを選ぶこともできます。mod が Claude Code の動作を変えるのは、この場合だけです。ステータス行には Sub-agents [1/1] · $0.00 のような短い要約も出ます。作者は Claude Code 2.1.296 と 2.1.307〜2.1.310 でテストしています。
デモ
録画では、小さなデモプロジェクトで mod を読み込んだ Claude Code を起動し、/agent-tree でペインを開きます。メインセッションは待機中で、サブエージェントはまだなく、セッションログも空です。続いて、サブエージェントで src/login.js を読んで一文で説明するよう頼みます。ペインは「作業中」に変わり、ログに「Round 1」の行が付き、general-purpose サブエージェントが実行中として現れます。メインセッションは「サブエージェント待ち」となり、コンテキストの数値が更新されます。エージェントが終わると、その回答が「メインセッションへ戻る」箱に数えられます。
インストール
インストールブロックのどの方法でも使えます。作者自身のマーケットプレイスから直接インストールされます。その後 /agent-tree でペインを開きます。
$ install agent-tree
Claude Code 2.1.287 以上が必要
作者のマーケットプレイスからインストール: MikeGT4/agent-tree
1.Claude Code 内で1行
/plugin install agent-tree --marketplace MikeGT4/agent-tree実行中のセッション(v2.1.275 以降)に貼り付けます。最初に Claude Code がマーケットプレイスの追加を確認します。
2.シェルから
claude plugin marketplace add MikeGT4/agent-tree claude plugin install agent-tree@agent-treeその後、すでに開いているセッションでは /reload-plugins を実行してください。
3.インストールせずに試す
git clone https://github.com/MikeGT4/agent-tree claude --plugin-dir ./agent-treeその1セッションだけ Mod を読み込みます。設定には何も追加されません。
仕組み
mod はツリー全体を 1 つの状態アトムに持ち、エージェントのイベントを監視します。agent.spawn でノードを追加し、tool.call でツールを数え、turn.step でモデル、effort、アドバイザーの利用を記録し、turn.complete でエージェントを完了、失敗、停止にします。ui.render がその状態からペインを描きます。250 ミリ秒のタイマーは、エージェントが動いている間だけスピナーを動かします。ツール呼び出しをゲートするのは停止機能で、hooks/register.tsx の該当部分は次のとおりです。
if (stoppingIds.has(agentId)) {
if (e.tool !== HANDBACK) {
const current = await read($, tree)
return { deny: wordsFor(lang).stopAnswer(current.agents.find(n => n.id === agentId)?.toolCount ?? 0) }
}影響を受けるのは、あなたが停止を指示したエージェントだけです。セッション由来のテキスト(タスク、回答、ツールラベル)は描画前に整形されます。端末のエスケープと制御文字を除去し、トークン、パスワード、KEY=value のような文字列は ••• に置き換えます。ツールラベルにはコマンド全体ではなく、ファイル名、プログラム名、ホスト名だけを出します。
カスタマイズ
/config には 5 つのオプションがあります。ドッキングしたペインの幅(既定 90 列、40〜140)、ツリーが保持するサブエージェント数(既定 30)、起動時に開く(既定はオフ)、モーション(スピナーと流れのアニメーション、既定はオン)、言語(auto、de、en)です。手でドラッグした幅が優先されます。ペイン内のキーは、m でモデル選択、0〜4 で選択、x で閉じる、詳細表示で s により停止、ctrl+x tab でペインにフォーカスです。
権限と安全性
プラグインが実行できるすべてのファイルを読みました。hooks/hooks.json、register.tsx、model.ts、view.tsx、words.ts、型宣言、テスト、README、PRIVACY.md です。package.json、インストールスクリプト、バイナリ、バンドルされたコードはありません。テキスト以外のファイルは PNG アイコンだけです。
- ネットワーク、プロセス、ファイル、デーモン、シークレット: いずれもありません。ネットワーク呼び出し、シェルコマンド、ファイル書き込み、環境変数、認証情報へのアクセスは見つからず、Claude Code の終了後に動き続けるものもありません。エージェントが動いていなければタイマーは止まります。
- 読み取るもの: エージェント一覧とサブエージェントのメッセージ(詳細表示用)、
languageとadvisorModelの設定、コンテキストとコストの数値です。 - テレメトリ: なし。
- ゲートするフック:
agent.spawnはモデル指定のない新しいサブエージェントにあなたが選んだモデルを付けます。turn.stepは実行中エージェントの次のステップを選んだモデルに切り替え、停止を押したときは短い報告に置き換えます。tool.callは停止したエージェントの以後のツール呼び出しを拒否します。3 つとも、ペインで操作した後にだけ働き、README と PRIVACY.md の説明と一致します。停止の報告は合成されたアシスタントメッセージで、ランダムな id を持つSubagentHandbackツール呼び出しを含みます。 - プロンプトインジェクション: 見つかりませんでした。mod はプロンプトにテキストを追加せず、隠し Unicode もありません。
- ライセンス: MIT、LICENSE ファイルあり。
claude plugin validate はエラーも警告も出しませんでした。プラグインディレクトリには hooks モジュール用の独自ルールがあり、validate はそれを適用しない旨の注記が出ます。作者の 63 件のテストは Claude Code 2.1.310 ですべて通りました。
- ツール呼び出しを傍受
- Claude が行うすべてのツール呼び出しを参照でき(tool.call / tool.check)、ブロックや変更も可能です。
- プロンプトを読み取る
- 入力内容と会話のトランスクリプトを参照できます(prompt.* / session.append / session.messages)。
- UI を変更
- Claude Code の画面に描画します。バンド、ペイン、ステータス表示、トーストなど(ui.render / $.ui.*)。
- コマンド・ツールを追加
- あなたや Claude が呼び出せる新しいスラッシュコマンドやツールを登録します($.command.register / $.tool.register)。
互換性とトラブルシューティング
macOS 上の Claude Code 2.1.310 で確認しました(validate、テスト、録画)。mod インターフェースが必要です。ペインが表示されない場合は、次を確認してください。
claude --versionが 2.1.287 以降であること。/agent-treeを実行したこと。ペインは既定では開きません。成功すると「Agent Tree opened」と表示されます。- 端末の幅が十分であること。84 列未満ではアドバイザー列がツリーの上に積まれ、ペイン幅が 40 列未満では窮屈になります。
- mod の読み込み前に始まったエージェントは、ペインを開いたときにエージェント一覧から取り込まれます。
- 通常のセッションでは何も出ません。サブエージェントがなければ「no sub-agents yet」と表示されます。
よくある質問
- Agent Tree はデータを送信したり、ネットワークにアクセスしたりしますか?
- いいえ。コードにネットワーク呼び出しはなく、作者の PRIVACY.md でも何もマシンの外に出ないとされています。動作中のセッションのツリーをメモリに保持するだけで、ファイルは書きません。
- ペインから実行中のサブエージェントを止められますか?
- はい。エージェントの種類をクリックして詳細を開き、停止(または s キー)を押します。そのエージェントの以後のツール呼び出しは拒否され、次のステップで「ユーザーが停止した」という短い報告が返されます。
- サブエージェントのモデルを変えられますか?
- はい。「モデル」ボタンで新しいサブエージェントのモデルファミリー(Haiku、Sonnet、Opus、Fable)を指定でき、実行中エージェントの箱にあるボタンで次のステップのモデルを切り替えます。呼び出し側がモデルを指定している場合は変更しません。
- ペインは常に開いていますか?
- 既定では開きません。/agent-tree で開き、/agent-tree stop で閉じ、/agent-tree clear でツリーを作り直します。「起動時に開く」設定を有効にすると、毎回のセッションで開きます。
- ラベルは英語ですか?
- 既定では言語設定に従い、ドイツ語か英語になります。Language オプションで de か en に固定できます。ログの時刻は 24 時間表記です。
# 関連する Mod
おすすめAgent Radar
実行中のサブエージェントごとに入力欄の上へ 1 行表示:経過時間、ツール数、現在の動作。/radar ペイン付き。
- プロンプト上部
- ペイン
- トースト
- ツール呼び出しを傍受
- プロンプトを読み取る
- UI を変更
- コマンド・ツールを追加
v2.1.291 で検証済み
おすすめAgent Profiler
Claude Code セッションの時間がどこで使われたかを、モデル待ち・ツール・サブエージェントに分けてステータスラインに表示。OTLP トレースも出力できます。
- ステータス
- ペイン
- トースト
- ファイルを書き込む
- ネットワーク
- ツール呼び出しを傍受
- UI を変更
- コマンド・ツールを追加
v2.1.303 で検証済み
同じカテゴリの Mod: ペインとダッシュボード、タイマー、ToDo、スタンドアップ。