⚠️ 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 | 🇸🇦 العربية | 🇮🇱 עברית
Traduzioni: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית
Risoluzione dei guasti runtime per agenti di codifica. Si integra con Claude Code e Codex. Intercetta loop, azioni pericolose e fughe di segreti prima che diventino incidenti. Latenza zero. Eseguito in locale.
Installa hook per uno o qualsiasi combinazione:
failproofai policies --install --cli opencode pi gemini(oppure--cli claude codex copilot cursor opencode pi gemini). Ometti--cliper il rilevamento automatico dei CLI installati e un prompt.
npm install -g failproofai
failproofai policies --install # o semplicemente esegui `failproofai` e accetta il prompt alla prima esecuzione
failproofai30 policy integrate si attivano immediatamente. Dashboard su localhost:8020. Disabilita il prompt alla prima esecuzione con FAILPROOFAI_NO_FIRST_RUN=1.
| Policy | Cosa blocca |
|---|---|
block-push-master |
Push diretti a main / master |
block-force-push |
git push --force |
block-work-on-main |
Commit, merge, rebase su main / master |
block-rm-rf |
Eliminazione ricorsiva di file |
sanitize-api-keys |
Chiavi API che perdono nel contesto dell'agente |
→ Tutte le 30 policy integrate
Inserisci un file in .failproofai/policies/ — si carica automaticamente, nessun flag necessario.
Esegui il commit e tutto il team lo avrà al prossimo 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();
},
});Tre decisioni disponibili per ogni policy:
| Decisione | Effetto |
|---|---|
allow() |
Consenti l'operazione |
deny(message) |
Bloccala — il messaggio torna all'agente |
instruct(message) |
Lasciala passare, ma aggiungi contesto al prossimo prompt dell'agente |
→ Guida alle policy personalizzate
Ogni chiamata di strumento che il tuo agente esegue viene registrata localmente. La dashboard mostra cosa è stato eseguito, cosa è stato bloccato e cosa la policy ha detto all'agente — così non stai indovinando quando qualcosa va storto. → Guida della dashboard
| Getting Started | Installazione e primi passi |
| Built-in Policies | Tutte le 30 policy con parametri |
| Custom Policies | Scrivi le tue |
| Configuration | Ambiti di configurazione e regole di merge |
| Dashboard | Monitor della sessione e attività della policy |
| Architecture | Come funziona il sistema di hook |
MIT con Commons Clause — gratuito per uso interno e personale; la rivendita commerciale di failproofai richiede un accordo separato. Vedi LICENSE per il testo completo.
Vedi CONTRIBUTING.md. Sono benvenute nuove policy, casi limite e traduzioni.
Compila prima di iniziare. Esegui
bun install && bun run buildper primo. Questo repository esegue i propri hook di failproofai su se stesso, e risolvono l'importfailproofainel bundle compilatodist/— senza una compilazione otterrai errori di hookCannot find package 'failproofai'. Ricompila dopo aver modificatosrc/. Vedi Build before the in-repo dev hooks will work.
Creato da Nivedit Jain e Nikita Agarwal. befailproof.ai