agentwatch

Un registratore di volo per le sessioni di Claude Code.

Lasci che Claude Code venga eseguito sulla tua macchina — a volte per ore, a volte con auto-approvazione. agentwatch registra silenziosamente ogni azione, così puoi tornare indietro e vedere esattamente cosa è successo.

npm install -g agentwatch-dev
agentwatch install

Tutto qui. Due comandi. agentwatch sta ora registrando ogni sessione di Claude Code.

I comandi che userai davvero

agentwatch last           # cosa è successo?
agentwatch danger         # c'è stato qualcosa di rischioso?
agentwatch report         # riepilogo settimanale su tutti i progetti

last è quello che eseguirai più spesso. Dopo una sessione — soprattutto una lunga in cui ti sei allontanato — ti fornisce una cronologia completa: ogni comando, ogni file toccato, ogni rischio segnalato.

danger cerca cose come rm -rf, sudo, curl | sh, scritture su .env o .ssh, push forzati — tutto ciò di cui vorresti essere a conoscenza.

report mostra i modelli nel tempo: su quali progetti stai usando di più l'AI, quali file vengono modificati continuamente, quali comandi falliscono ripetutamente.

Tutti i comandi

SESSION REVIEW
  agentwatch last              rivedi la sessione più recente
  agentwatch show <id>         mostra una sessione specifica tramite prefisso ID
  agentwatch sessions          elenca tutte le sessioni registrate (--all per l'elenco completo)
  agentwatch live              segui in tempo reale la sessione corrente nel terminale
  agentwatch commands          tutti i comandi bash con stato di superamento/fallimento
  agentwatch files             tutti i file toccati (Lettura/Modifica/Scrittura)
  agentwatch danger            segnala azioni potenzialmente pericolose
  agentwatch export [id]       esporta in markdown (--json per JSON)
  agentwatch tokens [id]       ripartizione dell'utilizzo dei token per una sessione

ANALYTICS
  agentwatch report [period]   report settimanale — progetti, hotspot, modelli
                               period: week (default), month, o numero di giorni
  agentwatch hotspots [n]      primi N file che l'AI modifica di più tra le sessioni
  agentwatch stats             statistiche aggregate con ripartizione per progetto

GESTIONE
  agentwatch dash              apre la dashboard web nel browser
  agentwatch status            verifica se agentwatch è installato e funzionante
  agentwatch prune [days]      elimina le sessioni più vecchie di N giorni (default: 30)
  agentwatch install           aggiunge hook a Claude Code
  agentwatch uninstall         rimuove gli hook (i log vengono conservati)

Hotspot dei file

agentwatch hotspots mostra quali file l'AI tocca di più in tutte le tue sessioni. I file modificati ripetutamente spesso indicano codice complesso, fragile o in fase di sviluppo attivo.

Cosa viene segnalato come pericoloso

I rischi critici e di avviso attivano notifiche macOS in tempo reale. Gli eventi di livello informativo vengono registrati silenziosamente.

Come funziona

agentwatch utilizza il sistema di hook di Claude Code:

1. Hook SessionStart — registra i metadati della sessione (cwd, modello, timestamp)
2. Hook PostToolUse — registra ogni invocazione dello strumento, invia notifica per rischi critici
3. Hook Stop — verifica anomalie rispetto alla tua linea di base storica, notifica se insolite
4. I log sono archiviati come JSONL in ~/.agentwatch/sessions/

Gli hook vengono eseguiti in modo asincrono con un timeout di 3 secondi e fallimento silenzioso — non bloccano né interferiscono mai con Claude Code. Tutti i dati rimangono locali sulla tua macchina.

Disinstallazione

agentwatch uninstall     # rimuove gli hook dalle impostazioni di Claude Code
npm uninstall -g agentwatch-dev

I log delle sessioni vengono conservati in ~/.agentwatch/ — elimina manualmente se lo desideri.

Requisiti

• Node.js 18+
• Claude Code

Licenza

MIT — creato da Farjad Ahmed