⚠️ 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 échecs 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. Latence zéro. Fonctionne en local.
Installez les hooks pour un ou plusieurs CLIs 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 qui est bloqué |
|---|---|
block-push-master |
Pushs directs vers main / master |
block-force-push |
git push --force |
block-work-on-main |
Commits, merges, rebases sur main / master |
block-rm-rf |
Suppression récursive de fichiers |
sanitize-api-keys |
Clés API qui fuient dans le contexte de l'agent |
Déposez un fichier dans .failproofai/policies/ — il se charge automatiquement, sans aucun flag.
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() |
Autoriser l'opération |
deny(message) |
La bloquer — le message est renvoyé à l'agent |
instruct(message) |
La laisser passer, mais ajouter du contexte au prochain prompt de l'agent |
→ Guide des politiques personnalisées
Chaque appel d'outil effectué par votre agent est journalisé en local. Le tableau de bord affiche ce qui s'est exécuté, ce qui a été bloqué, et ce que la politique a indiqué à l'agent — pour ne plus avoir à deviner quand quelque chose tourne mal. → 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 | Écrire 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 un usage interne et personnel ; la revente commerciale de failproofai lui-même nécessite un accord séparé. Voir LICENSE pour le texte complet.
Voir CONTRIBUTING.md. Nouvelles politiques, cas limites et traductions sont les bienvenus.
Construit par Nivedit Jain et Nikita Agarwal. befailproof.ai