Agent Radar：入力欄の上に出る Claude Code サブエージェント監視

Agent Radar は、Hamza Zafar（hamzafer）による claude-code-mods コレクションの一部で、コミュニティ Mod です。Claude Code のサブエージェント監視として働きます。Claude がサブエージェントに作業を任せると、入力欄の上の帯にそのサブエージェント用の行がリアルタイムで 1 行増え、何も開かなくても各エージェントの様子が分かります。

行はたとえば ● Read README and all src/ files 4s · 2 tools · searching src/**/* のようになります。エージェントの説明、経過時間、これまでのツール呼び出し回数、そして直近の呼び出しを表すわかりやすいラベルが並びます。エージェントが終了すると、点は緑のチェックに変わって 30 秒間残り、✓ sweep runner done (9s · 4 tools) のようなトーストが表示されます。失敗または中断したエージェントには、赤い×と理由が表示されます。

/radar を実行すると、「Agent Radar」というタイトルのペインが開きます。最大 9 件のエージェントがホットキー付きで並び、実行中の数と完了した数が表示され、1 件を開くと直近 6 件のメッセージを見られます。ペインには「Clear finished」ボタンがあります。Mod の読み込み前に開始したエージェントは、/radar を実行したときにエンジン自身のエージェント一覧から取り込まれます。トークン数やコストは表示しません。

録画では、Claude Code 2.1.291 と Haiku を使い、小さなデモプロジェクトで試しています。Claude に、scan src という名前の Explore サブエージェントで README.md と src/ の各ファイルを読むよう依頼します。Claude がそれをバックグラウンドエージェントとして起動すると、入力欄の上にすぐ黄色の行が現れます：● scan src 4s · 2 tools · searching src/**/*。時間とツール数は毎秒増え、サブエージェントが次のファイルに進むにつれて、ラベルは reading src/login.js に変わります。

上のインストールブロックは、作者のマーケットプレイスを追加し、そこからプラグインをインストールします。帯は、次にサブエージェントが起動したときに表示されます。すでに開いているセッションにインストールした場合は、/reload-plugins を実行してください。

Mod は、レーダーの状態をホストが保持する 3 つの $.state アトム（agents、selected、now）に保存するため、ホットリロードしても残ります。これを 4 つのフックが更新します。agent.spawn はエントリを追加し、tool.call は agentId を持つツール呼び出しを数え、turn.complete はエージェントを完了または失敗にしてトーストを出します。session.start で始まる 1 秒のクロックは、いずれかの行が表示されている間、経過時間を再描画します。ツール呼び出しのフックは hooks/register.tsx からの抜粋です。

on('tool.call', async ($, e, next) => {
  if (e.agentId) {
    const id = e.agentId
    const line = describe(e as unknown as Record<string, unknown>)
    await update($, agents, list => list.map(a => (a.id === id ? { ...a, tools: a.tools + 1, last: line } : a)))
  }
  return next(e)
})

呼び出しを実行させる前にカウンターを更新し、その後は next(e) の結果をそのまま返します。agentId を持たないメインエージェントの呼び出しは無視されます。describe は呼び出しを短いラベルに変換します。reading と editing にはパスの最後の 2 区間、searching にはパターンの先頭 30 文字、running には Bash の説明またはコマンドの先頭 50 文字、Playwright のツールには browser: click が付きます。帯は AbovePrompt の描画位置で、他の Mod や Claude Code がそこに置いたコンテンツの後に描画され、アンケートが開いている間は場所を譲ります。

/config に設定項目はありません。見た目を変えるには、register.tsx の先頭にある定数を編集します。SHOW_DONE_MS（完了した行を残す時間、30 秒）と BAND_ROWS（帯に表示する行数、4）です。エージェント一覧は agent.spawn フックで 30 件に制限されており、色と記号は icon 関数と color 関数で設定されています。

実行する前に、プラグインが読み込むすべてのファイルを確認しました：.claude-plugin/plugin.json、hooks/hooks.json、hooks/register.tsx、types/index.d.ts、テストファイルです。package.json、インストールスクリプト、バイナリ、バンドルされたコードはなく、隠し文字やゼロ幅文字も見つかりませんでした。リポジトリには MIT の LICENSE があります。

UI を変更する は、帯、ペイン、トーストを指します。コマンドを追加する は /radar を指します。Mod はネットワーク、シェルコマンド、ファイル書き込み、環境変数を使わず、メモリ上に保持される Claude Code のホスト状態の外には何も保存しません。バックグラウンドサービスも起動しません。1 秒のクロックはセッションに属し、エージェントの行が表示されている間だけ動きます。プロンプトやツールの結果には何も追加せず、モデルを呼び出すこともありません。

注意点は次のとおりです。Mod はマッチャーなしですべての tool.call と agent.spawn にフックするため、Bash コマンドやファイルパスなど、サブエージェントのツール名と入力を目にし、直近のものの短いラベルをメモリ上に保持します。それらを保存したり送信したりはしません。ペインでは、エージェントを開くと $.session.messages を通じて直近のメッセージを読み、ローカルで表示します（1 件あたり 400 文字で切り詰め）。最後に、claude plugin validate はエラーも警告も報告しませんでしたが、agent.spawn と tool.call のフックに .catch がないことを注記しています。どちらのフックも next(e) でイベントを渡すため、実際のリスクはブロックではなく、状態更新でエラーが投げられることです。作者の 2 件のテストは Claude Code 2.1.291 で成功しました。

macOS 上の Claude Code 2.1.291 で確認しました（validate とテスト）。帯が表示されない場合は次を確認してください。

• サブエージェントは現在のセッションで起動する必要があります。帯は、起動を見たエージェントだけを一覧にします。それ以前に起動したエージェントを取り込むには /radar を実行します。
• 入力欄の上でアンケートが開いています。閉じると帯は戻ります。
• 別のプラグインがすでに /radar を使っています。Claude Code はその名前を拒否し、Mod はコマンドなしで動作を続けます。
• 開いているセッションにインストールした場合は、/reload-plugins を実行してください。

Claude Code の「Agent view」フッターはこの Mod とは別のもので、入力欄の下に独自のエージェント一覧を表示します。