Saltar al contenido principal
Los hooks te permiten ejecutar lógica personalizada en respuesta a eventos del ciclo de vida del agente. Puedes usar hooks para aplicar políticas, agregar contexto, registrar acciones, modificar permisos o integrarlos con sistemas externos. Los hooks se configuran en formato JSON. Colócalos en el directorio .devin/ de tu proyecto (o en una configuración a nivel de usuario) y Devin CLI los ejecutará en los eventos del ciclo de vida que correspondan. Los hooks existentes en los directorios .claude/ también se detectan automáticamente — consulta Dónde se encuentran los hooks.

​
¿Qué pueden hacer los Hooks?

Aplicar políticas

Bloquear comandos peligrosos, exigir confirmación para acciones específicas o restringir el acceso a archivos.

Agregar contexto

Inyectar instrucciones o información adicional cuando se llaman herramientas específicas.

Ejecutar efectos secundarios

Ejecutar scripts, enviar notificaciones o registrar eventos cuando ocurren.

Modificar permisos

Otorgar o restringir permisos dinámicamente según la situación.

​
Ejemplo rápido

Crea .devin/hooks.v1.json en tu proyecto: 
{
  "PreToolUse": [
    {
      "matcher": "exec",
      "hooks": [
        {
          "type": "command",
          "command": "./scripts/check-command.sh"
        }
      ]
    }
  ]
}
Esto ejecuta ./scripts/check-command.sh antes de ejecutar cada comando de shell. El script recibe los datos del evento por stdin y puede impedir la ejecución devolviendo un código de salida distinto de cero.

​
Eventos de hooks

Los hooks pueden responder a estos eventos del ciclo de vida:
EventoCuándo se activa
PreToolUseAntes de que se ejecute una herramienta
PostToolUseDespués de que una herramienta termine
PermissionRequestCuando se requiere una decisión sobre permisos
UserPromptSubmitCuando el usuario envía un mensaje
StopCuando el agente quiere detenerse
SessionStartCuando comienza una sesión
SessionEndCuando termina una sesión
Consulta Hooks del ciclo de vida para obtener más información sobre cada evento y los datos disponibles.

​
Formato de los hooks

Cada hook tiene un tipo (command o prompt), un matcher opcional (una regex sobre el tool_name del evento del hook) y una configuración: 
{
  "PreToolUse": [
    {
      "matcher": "exec",
      "hooks": [
        {
          "type": "command",
          "command": "./scripts/validate.sh",
          "timeout": 10
        }
      ]
    }
  ]
}
CampoDescripción
matcherExpresión regular que se compara con tool_name del evento del hook. Una cadena vacía o la omisión de matcher coincide con todos los nombres de herramientas.
type"command" para ejecutar un comando de shell, o "prompt" para evaluar un prompt de LLM.
commandComando de shell que se debe ejecutar (para el tipo command).
promptPrompt de LLM que se debe evaluar (para el tipo prompt).
timeoutTiempo de espera en segundos (opcional).

​
Hooks de comando

Los hooks de comando ejecutan un comando de shell. Los datos del evento se envían como JSON a través de stdin, y el comando puede devolver JSON por stdout para controlar el resultado (consulta Formato de salida a continuación). Entrada (stdin): 
{
  "hook_event_name": "PreToolUse",
  "tool_name": "exec",
  "tool_input": {
    "command": "rm -rf /"
  }
}
La variable de entorno DEVIN_PROJECT_DIR se establece automáticamente como el directorio raíz del proyecto. Consulta Cómo usar el Matcher para conocer los nombres de las herramientas integradas y el formato de nombre de herramienta de MCP con los que puedes hacer coincidencias.

​
Formato de salida

Un hook de comando puede imprimir un objeto JSON en stdout para controlar el resultado. Para aprobar o bloquear una acción, devuelve un decision en el nivel superior (con un reason opcional): 
{
  "decision": "block",
  "reason": "Destructive command blocked by policy"
}
Para inyectar texto en el contexto del agente, devuelve additionalContext dentro de un objeto hookSpecificOutput identificado con el nombre del evento: 
{
  "hookSpecificOutput": {
    "hookEventName": "UserPromptSubmit",
    "additionalContext": "Remember: deploys require an approved change ticket."
  }
}
Campo de salidaDescripción
decision"approve" para permitir la acción, o "block" para denegarla
reasonExplicación que se muestra al agente
hookSpecificOutput.hookEventNameEvento al que se aplica este resultado (p. ej., UserPromptSubmit, SessionStart, PostToolUse)
hookSpecificOutput.additionalContextTexto que se inyecta en el contexto del agente (para UserPromptSubmit, SessionStart, PostToolUse)

​
Códigos de salida

CódigoSignificado
0Éxito — el hook continúa con normalidad
2Bloqueo — la acción se deniega
OtroError — se registra, pero no bloquea

​
Dónde se encuentran los hooks

Devin CLI lee los hooks de las siguientes ubicaciones. Todos usan el mismo formato JSON.

​
Nivel de proyecto

UbicaciónDescripción
.devin/hooks.v1.jsonArchivo de hooks independiente (recomendado)
.devin/config.jsonclave "hooks" en el archivo de configuración
.devin/config.local.jsonclave "hooks" (anulación local, incluida en .gitignore)
.claude/settings.jsonclave "hooks" (formato de Claude Code)
.claude/settings.local.jsonclave "hooks" (formato de Claude Code)

​
A nivel de usuario (global)

UbicaciónDescripción
~/.config/devin/config.json (%APPDATA%\devin\config.json en Windows)clave "hooks" en la configuración del usuario
~/.claude.jsonclave "hooks" (formato de Claude Code)
~/.claude/settings.jsonclave "hooks" (formato de Claude Code)
~/.claude/settings.local.jsonclave "hooks" (formato de Claude Code)
En .devin/hooks.v1.json, el objeto hooks es el archivo completo (no se necesita una clave contenedora). En todas las demás ubicaciones, hooks está anidado bajo la clave "hooks" dentro de un archivo de configuración.
Los hooks de las rutas .claude/ se cargan cuando read_config_from.claude está habilitado (de forma predeterminada). Si es necesario, puedes desactivarlo en tu configuración de usuario.

​
Verificar hooks

Usa el comando de barra diagonal /hooks para ver todos los hooks cargados actualmente y sus archivos de origen: 
/hooks

​
Próximos pasos

Hooks del ciclo de vida

Profundiza en cada tipo de evento y en qué datos hay disponibles.

Configuración

Controla de qué ubicaciones de configuración lee los hooks Devin CLI.