agentwatch

Ein Flugschreiber für Claude-Code-Sitzungen.

Du lässt Claude Code auf deinem Rechner laufen – manchmal stundenlang, manchmal mit Auto-Approval. agentwatch protokolliert still jede Aktion, damit du später nachsehen kannst, was genau passiert ist.

npm install -g agentwatch-dev
agentwatch install

Das war's. Zwei Befehle. agentwatch zeichnet jetzt jede Claude-Code-Sitzung auf.

Die Befehle, die du tatsächlich nutzen wirst

agentwatch last           # was ist gerade passiert?
agentwatch danger         # ist etwas Riskantes passiert?
agentwatch report         # wöchentliche Zusammenfassung über alle Projekte

last ist der Befehl, den du am häufigsten ausführen wirst. Nach einer Sitzung – besonders nach einer langen, bei der du zwischendurch weg warst – liefert er eine vollständige Chronik: jeden Befehl, jede berührte Datei, jede als riskant markierte Aktion.

danger durchsucht nach Dingen wie rm -rf, sudo, curl | sh, Schreibvorgänge auf .env oder .ssh, Force-Pushes – alles, was du wissen solltest.

report zeigt dir Muster im Zeitverlauf: an welchen Projekten du am häufigsten mit KI arbeitest, welche Dateien ständig geändert werden, welche Befehle wiederholt fehlschlagen.

Alle Befehle

SESSION-ÜBERSICHT
  agentwatch last              die letzte Sitzung anzeigen
  agentwatch show <id>         eine bestimmte Sitzung anhand der ID-Vorsilbe anzeigen
  agentwatch sessions          alle aufgezeichneten Sitzungen auflisten (--all für vollständige Liste)
  agentwatch live              aktuelle Sitzung im Terminal live verfolgen
  agentwatch commands          alle Bash-Befehle mit Erfolg/Fehler-Status
  agentwatch files             alle berührten Dateien (Lesen/Bearbeiten/Schreiben)
  agentwatch danger            potentiell gefährliche Aktionen markieren
  agentwatch export [id]       als Markdown exportieren (--json für JSON)
  agentwatch tokens [id]       Token-Verbrauchsaufschlüsselung für eine Sitzung

ANALYTIK
  agentwatch report [zeitraum] Wochenbericht – Projekte, Hotspots, Muster
                               Zeitraum: week (Standard), month oder Anzahl Tage
  agentwatch hotspots [n]      die Top-n Dateien, die KI über Sitzungen hinweg am meisten verändert
  agentwatch stats             aggregierte Statistiken mit Aufschlüsselung nach Projekt

VERWALTUNG
  agentwatch dash              Web-Dashboard im Browser öffnen
  agentwatch status            prüfen, ob agentwatch installiert ist und funktioniert
  agentwatch prune [tage]      Sitzungen löschen, die älter als N Tage sind (Standard: 30)
  agentwatch install           Hooks zu Claude Code hinzufügen
  agentwatch uninstall         Hooks entfernen (Protokolle bleiben erhalten)

Datei-Hotspots

agentwatch hotspots zeigt, welche Dateien KI über alle deine Sitzungen hinweg am häufigsten anfasst. Dateien, die wiederholt geändert werden, deuten oft auf komplexen, fragilen oder aktiv weiterentwickelten Code hin.

Was als gefährlich markiert wird

Kritische und Warn-Risiken lösen in Echtzeit macOS-Benachrichtigungen aus. Info-Stufen werden still protokolliert.

Wie es funktioniert

agentwatch nutzt das Hooks-System von Claude Code:

1. SessionStart-Hook – zeichnet Sitzungsmetadaten auf (Arbeitsverzeichnis, Modell, Zeitstempel)
2. PostToolUse-Hook – protokolliert jede Tool-Ausführung, sendet bei kritischen Risiken eine Benachrichtigung
3. Stop-Hook – prüft auf Anomalien im Vergleich zu deinem historischen Basiswert, benachrichtigt bei Ungewöhnlichem
4. Protokolle werden als JSONL in ~/.agentwatch/sessions/ gespeichert

Die Hooks laufen asynchron mit einem 3-Sekunden-Timeout und schlagen still fehl – sie blockieren oder stören Claude Code nie. Alle Daten bleiben lokal auf deinem Rechner.

Deinstallation

agentwatch uninstall     # entfernt Hooks aus den Claude-Code-Einstellungen
npm uninstall -g agentwatch-dev

Sitzungsprotokolle bleiben in ~/.agentwatch/ erhalten – lösche sie manuell, wenn du möchtest.

Voraussetzungen

• Node.js 18+
• Claude Code

Lizenz

MIT – erstellt von Farjad Ahmed