🪝 Hooks (automatización por eventos)

Los Hooks te permiten ejecutar acciones automáticas cuando ocurre un evento del runtime (por ejemplo, al iniciar una sesión o antes de ejecutar una herramienta).

✅ ¿Para qué sirven?

Casos de uso comunes:

Formatear código automáticamente después de editar.
Ejecutar linters/tests cuando el agente termine un cambio.
Registrar auditoría (logs) de comandos ejecutados.
Bloquear herramientas peligrosas en condiciones específicas.

🧭 Cómo se gestionan

En modo interactivo:

/hooks (menú de configuración)

Referencia: /guia/comandos-avanzados

🔁 Eventos típicos

Dependiendo de tu configuración, verás eventos como:

SessionStart (inicio de sesión)
PreToolUse (antes de ejecutar una herramienta)
PostToolUse (después de una herramienta)
Stop (fin de sesión/turno)

🧪 Buenas prácticas

Mantén los hooks rápidos (si demoran, aumentan latencia por turno).
Evita hooks que modifiquen archivos fuera del workspace.
En proyectos grandes, separa hooks por propósito (format vs test vs audit).