agentwatch

Un registrador de vuelo para sesiones de Claude Code.

Dejas que Claude Code se ejecute en tu máquina — a veces durante horas, a veces con aprobación automática. agentwatch registra silenciosamente cada acción, para que puedas volver y ver exactamente lo que sucedió.

npm install -g agentwatch-dev
agentwatch install

Eso es todo. Dos comandos. agentwatch ahora está grabando cada sesión de Claude Code.

Los comandos que realmente usarás

agentwatch last           # what just happened?
agentwatch danger         # did anything risky happen?
agentwatch report         # weekly summary across all projects

last es el que ejecutarás más a menudo. Después de una sesión — especialmente una larga en la que te alejaste — te da una cronología completa: cada comando, cada archivo tocado, cada riesgo señalado.

danger escanea cosas como rm -rf, sudo, curl | sh, escrituras en .env o .ssh, force pushes — cualquier cosa de la que quieras estar al tanto.

report muestra patrones a lo largo del tiempo: en qué proyectos usas más la IA, qué archivos se modifican repetidamente, qué comandos siguen fallando.

Todos los comandos

SESSION REVIEW
  agentwatch last              review the most recent session
  agentwatch show <id>         show a specific session by ID prefix
  agentwatch sessions          list all recorded sessions (--all for full list)
  agentwatch live              live-follow current session in terminal
  agentwatch commands          all bash commands with pass/fail status
  agentwatch files             all files touched (Read/Edit/Write)
  agentwatch danger            flag potentially dangerous actions
  agentwatch export [id]       export as markdown (--json for JSON)
  agentwatch tokens [id]       token usage breakdown for a session

ANALYTICS
  agentwatch report [period]   weekly report — projects, hotspots, patterns
                               period: week (default), month, or number of days
  agentwatch hotspots [n]      top N files AI modifies most across sessions
  agentwatch stats             aggregate stats with per-project breakdown

MANAGEMENT
  agentwatch dash              open web dashboard in browser
  agentwatch status            check if agentwatch is installed and working
  agentwatch prune [days]      delete sessions older than N days (default: 30)
  agentwatch install           add hooks to Claude Code
  agentwatch uninstall         remove hooks (logs are preserved)

Puntos calientes de archivos

agentwatch hotspots muestra qué archivos toca más la IA en todas tus sesiones. Los archivos que se modifican repetidamente a menudo indican código complejo, frágil o en desarrollo activo.

Qué se señala como peligroso

Los riesgos críticos y de advertencia activan notificaciones de macOS en tiempo real. Los eventos de nivel de información se registran silenciosamente.

Cómo funciona

agentwatch utiliza el sistema de ganchos de Claude Code:

1. Gancho SessionStart — registra metadatos de la sesión (cwd, modelo, marca de tiempo)
2. Gancho PostToolUse — registra cada invocación de herramienta, envía notificación en riesgos críticos
3. Gancho Stop — comprueba anomalías respecto a tu línea base histórica, notifica si es inusual
4. Los registros se almacenan como JSONL en ~/.agentwatch/sessions/

Los ganchos se ejecutan de forma asíncrona con un tiempo de espera de 3 segundos y fallo silencioso — nunca bloquean ni interfieren con Claude Code. Todos los datos permanecen locales en tu máquina.

Desinstalar

agentwatch uninstall     # removes hooks from Claude Code settings
npm uninstall -g agentwatch-dev

Los registros de sesión se conservan en ~/.agentwatch/ — bórralos manualmente si quieres.

Requisitos

• Node.js 18+
• Claude Code

Licencia

MIT — creado por Farjad Ahmed