> ## Documentation Index > Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt > Use this file to discover all available pages before exploring further. # Harnais d'agents > Capturez les sessions et appliquez des politiques dans les CLI d'agents pris en charge. Failproof AI prend en charge Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI et Goose. | Harnais | Portées de hooks prises en charge | | ------------------------------------------------ | --------------------------------- | | Claude Code | Utilisateur, projet, local | | Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | Utilisateur, projet | | Factory Droid, Devin CLI, Antigravity CLI, Goose | Utilisateur, projet | | Hermes, OpenClaw | Utilisateur | Chaque intégration normalise ses noms d'événements de hook natifs, ses noms d'outils et ses champs d'entrée d'outils avant l'exécution des politiques. Une politique ne peut agir que sur les événements exposés par le harnais ; testez le comportement en fin de tour et les instructions sur le harnais et la version exacts que vous déployez. ## Capacité d'application « Bloquer » signifie que le verdict retourné par l'adaptateur actuel est consommé par le harnais désigné. Le blocage post-outil peut remplacer le résultat présenté au modèle, mais ne peut pas annuler un effet secondaire d'outil déjà produit. | Harnais | Événements de blocage vérifiés | Mises en garde d'observation seule ou non bloquants | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, et plusieurs événements de tâche/configuration | `PostToolUse`, le cycle de vie de session, les notifications et les événements post-échec sont observationnels. | | Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Le blocage post-outil remplace le résultat après exécution ; les événements de démarrage de session et de compaction sont observationnels dans l'adaptateur actuel. | | GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Le blocage post-outil remplace le résultat après exécution ; les événements de session et de notification sont observationnels. | | Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` et les événements de session sont observationnels. | | OpenCode | `PreToolUse` | Les événements post-outil et de cycle de vie sont observationnels ; la gestion actuelle des arrêts constitue une directive pour un tour ultérieur plutôt qu'une barrière vérifiée. | | Pi | `PreToolUse`, `UserPromptSubmit` | Les événements post-outil et de cycle de vie sont observationnels ; la directive d'arrêt s'applique à un tour ultérieur. | | Hermes | `PreToolUse` | Les verdicts post-outil, de session et d'arrêt de sous-agent ne sont pas des barrières. | | OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Les événements post-outil, de session, d'arrêt de sous-agent et de compaction sont observationnels. | | Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Les verdicts post-outil et d'arrêt de sous-agent sont observationnels. | | Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` conditionnel | Les hooks de permission ne s'exécutent pas dans tous les modes de permission ; les événements post-outil et de session sont observationnels. | | Antigravity CLI | `PreToolUse`, `Stop` | Les verdicts de prompt utilisateur et post-outil sont observationnels ; des instructions de prompt peuvent néanmoins être injectées. | | Goose | `PreToolUse` | Les événements de prompt utilisateur, post-outil et de session sont observationnels. Un hook d'arrêt bloquant natif existe en amont, mais n'est pas installé par l'adaptateur actuel. | Les capacités sont sensibles à la version. Retestez après la mise à niveau d'un CLI d'agent, en particulier lorsqu'une politique repose sur le comportement des prompts, des arrêts, des permissions ou des outils post-exécution plutôt que sur la barrière commune pre-tool. ## Installer les hooks de capture et de politique 1. Ouvrez **Administration → Clés** et créez une clé avec les permissions `events:add` et `policies:pull`, nommée selon la machine ou l'environnement. 2. Sur la machine cible, connectez le CLI local avec la clé affichée et installez les hooks du harnais. 3. Démarrez une nouvelle session d'agent, puis confirmez ses événements de hook et de session sous **Observer → Événements**. 4. Ouvrez **Observer → Politique** pour la même fenêtre temporelle et confirmez qu'une décision de politique est attribuée à la machine. La connexion commence avec une clé machine. Assurez-vous qu'elle inclut les permissions d'ingestion et de livraison de politique avant de copier son secret. Le panneau de création de clé API permettant d'accorder les permissions d'ingestion d'événements et de livraison de politique. Après l'installation des hooks, le flux d'événements devrait afficher de nouveaux événements provenant de la machine et de l'environnement connectés. Le flux d'événements en direct permettant de confirmer qu'un harnais nouvellement installé envoie bien des rapports. Enfin, vérifiez que les décisions de politique sont attribuées à la même machine. Cela confirme que le harnais rapporte bien l'activité des politiques ainsi que les événements de trace. La page Politique permettant de vérifier les décisions de politique d'un harnais nouvellement connecté. Installez les hooks pour tous les harnais détectés : ```bash theme={null} failproofai config \ --connect https://app.befailproof.ai \ --token failproofai policies --install ``` Ou ciblez des harnais nommés et une portée de configuration : ```bash theme={null} failproofai policies --install \ --cli claude codex cursor \ --scope user ``` La portée projet conserve la configuration des hooks avec un dépôt. La portée utilisateur couvre le travail sur plusieurs dépôts. Claude Code prend également en charge la portée locale ; la prise en charge varie selon le harnais et le CLI rejette les combinaisons non prises en charge. Vérifiez la machine et ses événements : ```bash theme={null} failproofai config --status failproofai flush --wait fp events --since 1h --event-type hook_triggered,hook_completed ``` ## Ajouter un chemin de session non par défaut Les chemins supplémentaires sont enregistrés sur la machine, pas dans le Cloud. Après en avoir ajouté un, ouvrez **Observer → Sessions**, filtrez sur l'environnement de la machine, et confirmez que les sessions provenant du nouveau chemin apparaissent. Ouvrez une session et vérifiez l'agent, le harnais et les horodatages des événements avant de vous y fier dans un audit. La liste des sessions filtrée sur l'environnement recevant les données du chemin de capture supplémentaire. Ajoutez un chemin avec un libellé optionnel, puis inspectez les chemins configurés : ```bash theme={null} failproofai harness add-path claude checkout=/srv/checkout/.claude failproofai harness list claude failproofai backfill --since 7d --dry-run failproofai backfill --since 7d ``` Supprimez un chemin avec `failproofai harness remove-path claude checkout`. Lancez une nouvelle session après l'installation. Vérifiez à la fois le flux d'événements en direct et une décision de politique effective avant d'élargir le déploiement.