Agenten beobachten: Echtzeit-Dashboard zur Überwachung von Claude-Code-Agenten-Teams

Was Agents Observe leistet

Agents Observe ist ein Echtzeit-Beobachtbarkeits-Dashboard, das speziell für Claude Code Agent-Teams entwickelt wurde. Es schließt die Sichtbarkeitslücke, wenn Claude Code autonom läuft – durch das Erstellen von Sub-Agents, das Aufrufen von Tools, das Lesen von Dateien und das Ausführen von Befehlen – indem es jedes Hook-Ereignis in Echtzeit erfasst und an ein Live-Dashboard streamt.

Wichtige Funktionen und Architektur

Das Tool verwendet Claude Code Hooks statt OTEL (OpenTelemetry), um das zu erfassen, was der Entwickler als „das vollständige Bild der Agent-Aktionen“ beschreibt. Die Architektur folgt diesem Ablauf:

• Claude Code Hooks → observe_cli.mjs → API-Server (SQLite) → React Dashboard
• Das Hook-Skript liest Roh-Ereignisse von stdin, fügt den Projektnamen hinzu und sendet sie per POST an den Server
• Der Server analysiert Ereignisse, speichert Agent-Metadaten (Name, Typ, Elternschaft) und leitet Ereignisse an WebSocket-Clients weiter
• Das React-Dashboard leitet den gesamten Agent-Status aus dem Ereignisstrom ab

Mit dem Dashboard können Sie:

• Beobachten, wie Tool-Aufrufe in Echtzeit eintreffen (PreToolUse → PostToolUse mit Ergebnissen)
• Die vollständige Agent-Hierarchie sehen – welcher Sub-Agent von welchem Eltern-Agent erstellt wurde
• Nach Agent, Tool-Typ filtern oder über alle Ereignisse suchen
• Jedes Ereignis erweitern, um die vollständige Nutzlast, den Befehl und das Ergebnis zu sehen
• Auf Timeline-Symbole klicken, um zu bestimmten Ereignissen im Stream zu springen
• Historische Sitzungen mit menschenlesbaren Namen durchsuchen (z.B. „twinkly-hugging-dragon“)

Installation und Einrichtung

Voraussetzungen:

• Docker (erforderlich – der Server läuft als Container)
• Node.js (erforderlich – Hook-Skripte laufen über node)

Plugin-Installationsschritte:

claude plugin marketplace add simple10/agents-observe
claude plugin install agents-observe

Nach dem Neustart von Claude Code startet der Server automatisch als Docker-Container bei Ihrer nächsten Sitzung, und die Hooks beginnen mit der Erfassung von Ereignissen. Das Dashboard ist unter http://localhost:4981 verfügbar.

Plugin-Fähigkeiten

• /observe – Öffnet die Dashboard-URL und prüft, ob der Server läuft
• /observe status – Prüft die Server-Integrität und zeigt die Dashboard-URL an

Leistungseinblicke aus der Entwicklung

Der Entwickler teilte mehrere technische Erkenntnisse aus dem Bauen und Nutzen des Tools:

• Claude Code Hooks sind blockierend – die Leistung verschlechtert sich rapide mit vielen Plugins, die Hooks verwenden
• Hooks liefern nützlichere Informationen als OTEL-Daten
• Claudes jsonl-Dateien liefern das vollständige Bild
• Die Lebenszyklusverwaltung von MCP-Prozessen, die von Plugins gestartet werden, ist „etwas umständlich“
• Der Wechsel zu Hintergrund-Hooks (fire and forget) und das Entfernen anderer Plugins verbesserte Claudes Leistung erheblich

Der Entwickler implementierte eine Prozessmanagement-Lösung, bei der der Server aktive Verbindungen verfolgt und sich automatisch abschaltet, wenn er nicht genutzt wird, woraufhin das Plugin ihn bei Start einer neuen Sitzung wieder hochfährt. Dieser Docker-basierte Ansatz wird als Muster bezeichnet, das die Sicherheit durch die Isolierung von Diensten verbessern könnte.