Hooks - Devin Docs

Les hooks vous permettent d’exécuter une logique personnalisée en réaction à des événements du cycle de vie de l’agent. Vous pouvez utiliser des hooks pour appliquer des politiques, ajouter du contexte, consigner des actions, modifier des autorisations ou vous intégrer à des systèmes externes. Les hooks sont configurés au format JSON. Placez-les dans le répertoire .devin/ de votre projet (ou dans une configuration niveau utilisateur), et Devin CLI les exécute lors des événements correspondants du cycle de vie. Les hooks existants dans les répertoires .claude/ sont également détectés automatiquement — voir Où se trouvent les hooks.

Que peuvent faire les hooks ?

Appliquer des politiques

Bloquer les commandes dangereuses, exiger une confirmation pour des actions spécifiques ou restreindre l’accès aux fichiers.

Ajouter du contexte

Injecter des instructions ou des informations supplémentaires lorsque des outils spécifiques sont appelés.

Déclencher des effets secondaires

Exécuter des scripts, envoyer des notifications ou consigner des événements lors de certains événements.

Modifier les autorisations

Accorder ou restreindre dynamiquement les autorisations selon la situation.

Exemple rapide

Créez .devin/hooks.v1.json dans votre projet :

{
  "PreToolUse": [
    {
      "matcher": "exec",
      "hooks": [
        {
          "type": "command",
          "command": "./scripts/check-command.sh"
        }
      ]
    }
  ]
}

./scripts/check-command.sh est exécuté avant chaque exécution de commande shell. Le script reçoit les données d’événement via stdin et peut bloquer l’opération en renvoyant un code de sortie non nul.

Événements des hooks

Les hooks peuvent réagir aux événements de cycle de vie suivants :

Événement	Quand il se déclenche
`PreToolUse`	Avant l’exécution d’un outil
`PostToolUse`	Après l’exécution d’un outil
`PermissionRequest`	Lorsqu’une décision d’autorisation est requise
`UserPromptSubmit`	Lorsque l’utilisateur envoie un message
`Stop`	Lorsque l’agent souhaite s’arrêter
`SessionStart`	Lorsqu’une session démarre
`SessionEnd`	Lorsqu’une session se termine

Consultez les hooks de cycle de vie pour en savoir plus sur chaque événement et les données disponibles associées.

Format des hooks

Chaque hook comporte un type (command ou prompt), un matcher facultatif (une regex appliquée au tool_name de l’événement du hook) et une configuration :

{
  "PreToolUse": [
    {
      "matcher": "exec",
      "hooks": [
        {
          "type": "command",
          "command": "./scripts/validate.sh",
          "timeout": 10
        }
      ]
    }
  ]
}

Champ	Description
`matcher`	Expression régulière appliquée à `tool_name` de l’événement de hook. Une chaîne vide ou l’absence de `matcher` correspond à tous les noms d’outil.
`type`	`"command"` pour exécuter une commande shell, ou `"prompt"` pour évaluer un prompt de LLM.
`command`	Commande shell à exécuter (pour le type `command`).
`prompt`	Prompt de LLM à évaluer (pour le type `prompt`).
`timeout`	Délai d’expiration en secondes (facultatif).

Hooks de commande

Les hooks de commande lancent une commande shell. Les données d’événement sont transmises au format JSON sur stdin, et la commande peut renvoyer du JSON sur stdout pour en contrôler le résultat (consultez Format de sortie ci-dessous). Entrée (stdin):

{
  "hook_event_name": "PreToolUse",
  "tool_name": "exec",
  "tool_input": {
    "command": "rm -rf /"
  }
}

La variable d’environnement DEVIN_PROJECT_DIR est automatiquement définie sur le répertoire racine du projet. Consultez Utiliser le Matcher pour connaître les noms des outils intégrés et le format des noms d’outils MCP sur lesquels vous pouvez effectuer une correspondance.

Format de sortie

Un hook de commande peut afficher un objet JSON sur stdout pour contrôler l’issue. Pour approuver ou bloquer une action, renvoyez un champ decision à la racine (avec un champ reason facultatif) :

{
  "decision": "block",
  "reason": "Destructive command blocked by policy"
}

Pour injecter du texte dans le contexte de l’agent, renvoyez additionalContext dans un objet hookSpecificOutput identifié par le nom de l’événement :

{
  "hookSpecificOutput": {
    "hookEventName": "UserPromptSubmit",
    "additionalContext": "Remember: deploys require an approved change ticket."
  }
}

Pour réécrire de manière transparente l’entrée d’un outil avant son exécution, renvoyez updatedInput dans un objet hookSpecificOutput identifié par PreToolUse. Les champs de updatedInput sont fusionnés avec les arguments de l’outil, vous pouvez donc en mettre à jour un sous-ensemble (p. ex. seulement command) :

{
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "updatedInput": {
      "command": "rtk git status"
    }
  }
}

Champ de sortie	Description
`decision`	`"approve"` pour autoriser l’action, ou `"block"` pour la refuser
`reason`	Explication affichée à l’agent
`hookSpecificOutput.hookEventName`	Événement auquel cette sortie s’applique (p. ex. `UserPromptSubmit`, `SessionStart`, `PreToolUse`, `PostToolUse`)
`hookSpecificOutput.additionalContext`	Texte injecté dans le contexte de l’agent (pour `UserPromptSubmit`, `SessionStart`, `PostToolUse`)
`hookSpecificOutput.updatedInput`	Objet fusionné aux arguments de l’outil avant l’exécution (pour `PreToolUse`)

Codes de sortie

Code	Signification
0	Succès — le hook continue normalement
2	Blocage — l’action est refusée
Autre	Erreur — consignée dans les logs, mais ne bloque pas

Où se trouvent les hooks

Devin CLI lit les hooks aux emplacements suivants. Ils utilisent tous le même format JSON.

Au niveau du projet

Emplacement	Description
`.devin/hooks.v1.json`	Fichier de hooks autonome (recommandé)
`.devin/config.json`	Clé `"hooks"` dans le fichier de configuration
`.devin/config.local.json`	Clé `"hooks"` (surcharge locale, ignorée par Git)
`.claude/settings.json`	Clé `"hooks"` (format Claude Code)
`.claude/settings.local.json`	Clé `"hooks"` (format Claude Code)

Niveau utilisateur (global)

Emplacement	Description
`~/.config/devin/config.json` (`%APPDATA%\devin\config.json` sous Windows)	Clé `"hooks"` dans la configuration utilisateur
`~/.claude.json`	Clé `"hooks"` (format Claude Code)
`~/.claude/settings.json`	Clé `"hooks"` (format Claude Code)
`~/.claude/settings.local.json`	Clé `"hooks"` (format Claude Code)

Dans .devin/hooks.v1.json, l’objet hooks correspond à l’intégralité du fichier (sans clé enveloppante). Dans tous les autres emplacements, les hooks sont imbriqués sous la clé "hooks" dans un fichier de configuration.

Les hooks issus des chemins .claude/ sont chargés lorsque read_config_from.claude est activé (par défaut). Vous pouvez désactiver ce comportement dans votre configuration utilisateur si nécessaire.

Vérifier les hooks

Utilisez la commande /hooks pour afficher tous les hooks actuellement chargés ainsi que leurs fichiers sources :

/hooks

Étapes suivantes

hook de cycle de vie

Découvrez en détail chaque type d’événement et les données disponibles.

Configuration

Contrôlez les emplacements de configuration depuis lesquels Devin CLI lit les hooks.

​Que peuvent faire les hooks ?

Appliquer des politiques

Ajouter du contexte

Déclencher des effets secondaires

Modifier les autorisations

​Exemple rapide

​Événements des hooks

​Format des hooks

​Hooks de commande

​Format de sortie

​Codes de sortie

​Où se trouvent les hooks

​Au niveau du projet

​Niveau utilisateur (global)

​Vérifier les hooks

​Étapes suivantes

hook de cycle de vie

Configuration

Que peuvent faire les hooks ?

Exemple rapide

Événements des hooks

Format des hooks

Hooks de commande

Format de sortie

Codes de sortie

Où se trouvent les hooks

Au niveau du projet

Niveau utilisateur (global)

Vérifier les hooks

Étapes suivantes