Hooks

Les Hooks vous permettent d'automatiser les réactions aux événements dans Crew. Lorsqu'un outil se déclenche, qu'une session démarre ou qu'un fichier change, un Hook peut exécuter un script, injecter du contexte ou bloquer l'action.

Ouvrez Agent Capabilities → Hooks. Vous pouvez consulter, créer, modifier et supprimer des Hooks à partir du navigateur. Chaque Hook affiche son déclencheur, son action et, s'il y a lieu, un modèle de correspondance optionnel.

Les Hooks sont des fichiers JSON situés dans ~/.kiro/crew/hooks/ (ou, au niveau du projet, dans .kiro/hooks/). Chaque fichier peut définir un ou plusieurs Hooks.

Un Hook comporte trois parties :

1. Déclencheur — quand se déclenche-t-il?
2. Correspondance (optionnelle) — quels événements précis correspondent? (expression régulière sur le nom de l'outil ou le chemin du fichier)
3. Action — que se passe-t-il? (exécuter une commande ou injecter une requête)

Exécute une commande shell. La commande reçoit le contexte de la session en JSON sur l'entrée standard (stdin).

À utiliser pour : exécuter des analyseurs de code (linters), déclencher des builds, envoyer des notifications, valider des changements.

Les codes de sortie ont de l'importance :

• 0 — succès (la sortie est transmise pour certains déclencheurs)
• 2 — bloquer l'action (pour PreToolUse, UserPromptSubmit)
• Autre — échec silencieux, aucun blocage

Injecte une requête statique dans le contexte du modèle.

À utiliser pour : ajouter des rappels, faire respecter des modèles, injecter du contexte sur l'état actuel.

Un Hook qui exécute l'analyseur de code chaque fois qu'un fichier TypeScript est enregistré :

• Déclencheur : PostFileSave
• Correspondance : \.(ts|tsx)$
• Action : commande — npm run lint

Un Hook qui ajoute un rappel avant toute écriture de fichier :

• Déclencheur : PreToolUse
• Correspondance : fs_write|str_replace
• Action : agent — « Vérifiez que cette écriture respecte nos normes de programmation avant de poursuivre. »

• Déclencheur : PostTaskExec
• Action : commande — npm run test

Les Hooks PreToolUse peuvent bloquer un appel d'outil en se terminant avec le code 2. C'est ainsi que vous ajoutez des règles de refus personnalisées en plus des 137 modèles intégrés. L'agent voit le blocage et tente une approche différente.

1. Ouvrez Agent Capabilities → Hooks
2. Cliquez sur Add hook
3. Choisissez un déclencheur, définissez éventuellement une expression régulière de correspondance, sélectionnez le type d'action
4. Pour les actions de commande : entrez la commande shell
5. Pour les actions d'agent : entrez le texte de la requête
6. Enregistrez

Le Hook est actif immédiatement — aucun redémarrage n'est nécessaire.