README.it.md

⚠️ 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 di runtime per gli agenti di codifica. Si integra con Claude Code e Codex. Rileva cicli, azioni pericolose e perdite di segreti prima che diventino incidenti. Zero latenza. Esegui localmente.

---

CLI degli agenti supportati

                    

             

Installa gli hook per uno o qualsiasi combinazione: failproofai policies --install --cli opencode pi gemini (o --cli claude codex copilot cursor opencode pi gemini). Ometti --cli per il rilevamento automatico dei CLI installati e il prompt. Il supporto per GitHub Copilot CLI, Cursor Agent, OpenCode, Pi e Gemini CLI è in beta — il test è in corso.

---

Installazione

npm install -g failproofai
failproofai policies --install
failproofai

30 politiche integrate si attivano immediatamente. Dashboard su localhost:8020.

---

Cosa blocca

Politica	Cosa blocca
block-push-master	Push diretti su 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 politiche integrate

---

Le tue politiche personali

Rilascia un file in .failproofai/policies/ — si carica automaticamente, nessun flag necessario. Eseguine il commit e l'intero team lo riceverà 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 politica:

Decisione	Effetto
allow()	Permetti l'operazione
deny(message)	Bloccala — il messaggio torna all'agente
instruct(message)	Lasciarla passare, ma aggiungi contesto al prossimo prompt dell'agente

→ Guida alle politiche personalizzate

---

Visibilità della sessione

Ogni chiamata di strumento che il tuo agente esegue viene registrata localmente. Il dashboard mostra cosa è stato eseguito, cosa è stato bloccato e cosa la politica ha detto all'agente — quindi non stai indovinando quando qualcosa va male. → Guida al dashboard

---

Documentazione

Guida introduttiva	Installazione e primi passi
Politiche integrate	Tutte le 30 politiche con parametri
Politiche personalizzate	Scrivi le tue
Configurazione	Ambiti di configurazione e regole di unione
Dashboard	Monitor di sessione e attività delle politiche
Architettura	Come funziona il sistema di hook

---

Licenza

MIT con Commons Clause — gratuito per uso interno e personale; la rivendita commerciale di failproofai stesso richiede un accordo separato. Vedi LICENSE per il testo completo.

---

Contribuire

Vedi CONTRIBUTING.md. Nuove politiche, edge case e traduzioni sono tutti benvenuti.

---

Realizzato da Nivedit Jain e Nikita Agarwal. befailproof.ai