⚠️ This is an auto-generated translation. For the latest version, see the English README. Community corrections welcome!
🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית
Traductions : 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית
Résolution des erreurs d'exécution pour les agents de codage. S'intègre à Claude Code et Codex. Détecte les boucles, les actions dangereuses et les fuites de secrets avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local.
Installez les hooks pour un ou plusieurs agents en combinaison :
failproofai policies --install --cli opencode pi gemini(ou--cli claude codex copilot cursor opencode pi gemini). Omettez--clipour détecter automatiquement les CLIs installés et être invité à choisir.
npm install -g failproofai
failproofai policies --install # ou lancez simplement `failproofai` et acceptez l'invite au premier démarrage
failproofai30 politiques intégrées s'activent immédiatement. Tableau de bord disponible sur localhost:8020. Désactivez l'invite au premier démarrage avec FAILPROOFAI_NO_FIRST_RUN=1.
| Politique | Ce qu'elle bloque |
|---|---|
block-push-master |
Pushs directs vers main / master |
block-force-push |
git push --force |
block-work-on-main |
Commits, fusions et rebases sur main / master |
block-rm-rf |
Suppression récursive de fichiers |
sanitize-api-keys |
Fuites de clés API dans le contexte de l'agent |
Déposez un fichier dans .failproofai/policies/ — il se charge automatiquement, sans aucun paramètre.
Commitez-le et toute l'équipe en bénéficiera au prochain pull.
import { customPolicies, deny, allow } from "failproofai";
customPolicies.add({
name: "no-production-writes",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolInput?.file_path?.includes("production"))
return deny("Writes to production paths are blocked.");
return allow();
},
});Trois décisions disponibles pour chaque politique :
| Décision | Effet |
|---|---|
allow() |
Autorise l'opération |
deny(message) |
La bloque — le message est renvoyé à l'agent |
instruct(message) |
Laisse passer, mais ajoute du contexte au prochain prompt de l'agent |
→ Guide des politiques personnalisées
Chaque appel d'outil effectué par votre agent est enregistré localement. Le tableau de bord affiche ce qui s'est exécuté, ce qui a été bloqué et ce que la politique a communiqué à l'agent — pour ne plus jamais avoir à deviner ce qui s'est passé en cas de problème. → Guide du tableau de bord
| Démarrage rapide | Installation et premiers pas |
| Politiques intégrées | Les 30 politiques avec leurs paramètres |
| Politiques personnalisées | Écrivez les vôtres |
| Configuration | Portées de configuration et règles de fusion |
| Tableau de bord | Moniteur de session et activité des politiques |
| Architecture | Fonctionnement du système de hooks |
MIT avec Commons Clause — gratuit pour usage interne et personnel ; la revente commerciale de failproofai lui-même nécessite un accord séparé. Consultez LICENSE pour le texte intégral.
Consultez CONTRIBUTING.md. Les nouvelles politiques, cas limites et traductions sont les bienvenus.
Compilez avant de commencer. Exécutez d'abord
bun install && bun run build. Ce dépôt fait tourner ses propres hooks failproofai sur lui-même, et ils résolvent l'importfailproofaidepuis le bundle compilédist/— sans compilation, vous obtiendrez des erreurs de hookCannot find package 'failproofai'. Recompilez après toute modification danssrc/. Consultez Build before the in-repo dev hooks will work.
Développé par Nivedit Jain et Nikita Agarwal. befailproof.ai