Agent Radar: ein Claude Code Subagent-Monitor über der Eingabe

Agent Radar ist eine Community-Mod von Hamza Zafar (hamzafer) aus seiner Sammlung claude-code-mods. Sie ist ein Claude Code Subagent-Monitor: Wenn Claude Arbeit an einen Subagent übergibt, bekommt das Band über der Eingabe eine Live-Zeile dafür, sodass du siehst, was jeder einzelne tut, ohne etwas zu öffnen.

Eine Zeile sieht so aus: ● Read README and all src/ files 4s · 2 tools · searching src/**/*. Sie enthält die Beschreibung des Agents, die verstrichene Zeit, wie viele Tool-Aufrufe er gemacht hat, und ein verständliches Label für den letzten Aufruf. Wenn der Agent fertig ist, wird der Punkt für 30 Sekunden zu einem grünen Haken, und ein Toast wie ✓ sweep runner done (9s · 4 tools) erscheint. Ein fehlgeschlagener oder abgebrochener Agent bekommt ein rotes Kreuz und den Grund.

/radar öffnet ein Pane mit dem Titel „Agent Radar“. Es listet bis zu neun Agents mit je einem Hotkey, zeigt, wie viele laufen und wie viele fertig sind, und lässt dich einen öffnen, um seine letzten sechs Nachrichten zu sehen. Das Pane hat den Button „Clear finished“. Agents, die vor dem Laden der Mod gestartet wurden, werden beim Ausführen von /radar aus der eigenen Agent-Liste der Engine übernommen. Die Mod zeigt weder Token-Zahlen noch Kosten.

Die Aufnahme zeigt Claude Code 2.1.291 mit Haiku in einem kleinen Demoprojekt. Wir bitten Claude, einen Explore-Subagent namens scan src zu nutzen, der README.md und jede Datei in src/ liest. Claude startet ihn als Hintergrund-Agent, und sofort erscheint eine gelbe Zeile über der Eingabe: ● scan src 4s · 2 tools · searching src/**/*. Zeit und Tool-Anzahl steigen jede Sekunde, und das Label wechselt zu reading src/login.js, während der Subagent von einer Datei zur nächsten geht.

Der Installationsblock oben fügt den Marketplace des Autors hinzu und installiert das Plugin daraus. Das Band erscheint, sobald das nächste Mal ein Subagent startet. Nach der Installation in eine bereits offene Sitzung führe /reload-plugins aus.

Die Mod hält den Radar-Zustand in drei vom Host gehaltenen $.state-Atomen (agents, selected, now), sodass er einen Hot Reload übersteht. Vier Hooks füttern ihn. agent.spawn fügt einen Eintrag hinzu, tool.call zählt Tool-Aufrufe mit einer agentId, und turn.complete markiert den Agent als fertig oder fehlgeschlagen und löst den Toast aus. Ein Ein-Sekunden-Takt, der bei session.start startet, zeichnet die verstrichenen Zeiten neu, solange eine Zeile angezeigt wird. Der Tool-Call-Hook aus 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)
})

Er aktualisiert den Zähler, bevor er den Aufruf laufen lässt, und gibt dann das Ergebnis von next(e) unverändert zurück. Aufrufe des Haupt-Agents, die keine agentId haben, werden ignoriert. describe macht aus einem Aufruf ein kurzes Label: reading und editing plus die letzten zwei Pfadsegmente, searching plus die ersten 30 Zeichen eines Musters, running plus eine Bash-Beschreibung oder die ersten 50 Zeichen des Befehls und browser: click für Playwright-Tools. Das Band wird an der Render-Stelle AbovePrompt gezeichnet, nach dem Inhalt, den andere Mods und Claude Code dort ablegen, und weicht zurück, solange eine Umfrage offen ist.

In /config gibt es keine Optionen. Um das Aussehen zu ändern, bearbeite die Konstanten am Anfang von register.tsx: SHOW_DONE_MS (wie lange eine fertige Zeile bleibt, 30 Sekunden) und BAND_ROWS (wie viele Zeilen das Band zeigt, 4). Die Agent-Liste ist im Hook agent.spawn auf 30 Einträge begrenzt, und Farben und Symbole werden in den Funktionen icon und color festgelegt.

Wir haben jede Datei gelesen, die das Plugin lädt, bevor wir irgendetwas ausgeführt haben: .claude-plugin/plugin.json, hooks/hooks.json, hooks/register.tsx, types/index.d.ts und die Testdatei. Es gibt keine package.json, kein Installationsskript, keine Binärdatei und keinen gebündelten Code, und wir haben keine versteckten oder unsichtbaren Zeichen gefunden. Das Repository hat eine LICENSE unter MIT.

Ändert die UI umfasst das Band, das Pane und die Toasts. Fügt einen Befehl hinzu umfasst /radar. Die Mod nutzt kein Netzwerk, keine Shell-Befehle, keine Dateischreibzugriffe und keine Umgebungsvariablen, und sie speichert nichts außerhalb des Host-Zustands von Claude Code, der im Arbeitsspeicher gehalten wird. Sie startet keinen Hintergrunddienst: Der Ein-Sekunden-Takt gehört zur Sitzung und läuft nur, solange eine Agent-Zeile angezeigt wird. Sie fügt weder Prompts noch Tool-Ergebnissen etwas hinzu und ruft nie das Modell auf.

Die erwähnenswerten Punkte: Die Mod hängt sich ohne Matcher an jedes tool.call und agent.spawn, sieht also Tool-Namen und Eingaben von Subagents, etwa einen Bash-Befehl oder einen Dateipfad, und behält ein kurzes Label des letzten im Speicher. Sie speichert oder sendet sie nicht. Im Pane liest das Öffnen eines Agents seine letzten Nachrichten über $.session.messages und zeigt sie lokal an, jeweils auf 400 Zeichen gekürzt. Schließlich meldete claude plugin validate keine Fehler und keine Warnungen, merkte aber an, dass die Hooks agent.spawn und tool.call kein .catch haben. Beide Hooks reichen das Event mit next(e) weiter, das praktische Risiko ist also ein geworfener Fehler bei einer Statusaktualisierung, kein Blockieren. Die 2 Tests des Autors liefen auf Claude Code 2.1.291 erfolgreich durch.

Geprüft mit Claude Code 2.1.291 unter macOS (validate und Tests). Wenn das Band nicht erscheint:

• Ein Subagent muss in der aktuellen Sitzung starten; das Band listet nur Agents, deren Start es gesehen hat. Führe /radar aus, um früher gestartete Agents zu übernehmen.
• Über der Eingabe ist eine Umfrage offen; das Band kommt zurück, sobald sie schließt.
• Ein anderes Plugin belegt /radar bereits. Claude Code lehnt den Namen ab, und die Mod läuft ohne den Befehl weiter.
• In eine offene Sitzung installiert: Führe /reload-plugins aus.

Die Fußzeile „Agent view“ von Claude Code ist unabhängig von dieser Mod und zeigt unter der Eingabe ihre eigene Agent-Liste.