Vai al contenuto principale

​
Requisiti

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (facoltativo - necessario solo per la compilazione dal sorgente)

​
Installazione

npm install -g failproofai

​
Avvio rapido

1

Abilita le policy

Le policy sono regole che vengono eseguite prima e dopo ogni chiamata a uno strumento dell’agente. Intercettano comandi distruttivi, fughe di segreti e altre modalità di errore prima che causino danni.
failproofai policies --install
Questo scrive voci di hook nel file settings.json di Claude Code. Puoi anche installare per un singolo progetto o selezionare policy specifiche:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

Verifica

failproofai policies
Mostra ogni policy, se è abilitata e tutti i parametri configurati.
3

Avvia il dashboard

failproofai
Apre un dashboard locale su http://localhost:8020 dove puoi esplorare le sessioni, ispezionare le chiamate agli strumenti e gestire le policy.
4

Esegui il tuo agente

Avvia Claude Code come al solito. Se l’agente tenta qualcosa di rischioso, failproofai lo intercetta automaticamente. Lascialo in esecuzione senza supervisione e rivedi cosa è accaduto nel dashboard.

​
Come funzionano le policy

Ogni volta che un agente esegue uno strumento, Claude Code chiama failproofai come sottoprocesso: 
Claude Code  →  failproofai --hook PreToolUse  →  legge JSON da stdin
                                                 valuta le policy
                                                 scrive la decisione su stdout
Ogni policy restituisce una di tre decisioni:
  • allow - l’agente procede normalmente
  • deny - l’azione è bloccata, all’agente viene spiegato il motivo
  • instruct - viene aggiunto contesto aggiuntivo al prompt dell’agente
Le policy vengono eseguite nel tuo processo locale. Nulla viene inviato a un servizio remoto.

​
Archiviazione dei dati

Tutta la configurazione e i log rimangono sul tuo computer:
PercorsoCosa archivia
~/.failproofai/policies-config.jsonConfigurazione globale delle policy
~/.failproofai/hook-activity.jsonlCronologia dell’esecuzione degli hook
~/.failproofai/hook.logLog di debug per errori hook personalizzati
.failproofai/policies-config.jsonConfigurazione per progetto (committed)
.failproofai/policies-config.local.jsonPersonalizzazioni personali (gitignored)

​
Disinstallazione

failproofai policies --uninstall
Rimuove le voci di hook da ~/.claude/settings.json. I file di configurazione in ~/.failproofai/ vengono conservati.

​
Prossimi passaggi

Configurazione

Scope e formato del file di configurazione

Policy integrate

Tutte le 26 policy con parametri

Policy personalizzate

Scrivi le tue policy in JavaScript

Monitor agente

Monitora le sessioni e esamina l’attività delle policy