Failproof AI CLI

Installa la CLI locale con npm install -g failproofai. Eseguila senza argomenti per aprire il dashboard delle politiche locali. Il pacchetto richiede Node.js 20.9 o versioni successive. Bun 1.3 o versioni successive è supportato per sviluppo e installazioni da codice sorgente. failproofai configure e failproofai setup sono alias per failproofai config; failproofai p è un alias per failproofai policies.

Configura una macchina

npm install -g failproofai
failproofai config \
  --connect https://app.befailproof.ai \
  --token <machine-key> \
  --machine-label checkout-prod-01
failproofai policies --install
failproofai config --status

Esegui failproofai senza argomenti per aprire il dashboard delle politiche locali.

Comando	Risultato
`failproofai config`	Esegui la configurazione interattiva della macchina
`failproofai config --connect <url> --token <key>`	Connetti l’acquisizione Cloud e la distribuzione delle politiche
`failproofai config --status`	Mostra lo stato della connessione, del daemon, della distribuzione e della pausa
`failproofai policies`	Elenca le politiche integrate, personalizzate, convenzionali, pack e gestite da Cloud
`failproofai policies --install`	Installa gli hook e abilita le politiche
`failproofai policy add <name>`	Abilita una politica — una integrata o `<pack-id>:<name>` da un pack installato
`failproofai policy remove <name>`	Disabilita una politica, stessa nomenclatura
`failproofai policies --uninstall`	Disabilita le politiche o rimuovi gli hook del harness
`failproofai pack list`	Elenca i pack di politiche installati e tutte le politiche che contengono
`failproofai pack add <source>`	Installa un pack di politiche da un rilascio GitHub; senza tag prende il più recente e lo blocca
`failproofai pack add --bundled`	Installa le politiche integrate come pack, da questo pacchetto, senza rete
`failproofai pack build <entry.mjs>`	Costruisci i tre asset di rilascio per un pack tuo
`failproofai pack remove <publisher/name>`	Disattiva un pack installato
`failproofai audit`	Scansiona la cronologia locale dell’agente e apri la vista di audit locale
`failproofai audit --schedule [days] --email <address>`	Pianifica scansioni locali ricorrenti e invia i risultati via email
`failproofai audit --status`	Mostra l’indirizzo del report, l’intervallo e la prossima scansione pianificata
`failproofai audit --no-schedule`	Interrompi le scansioni ricorrenti senza eliminare la cronologia di audit
`failproofai harness list`	Elenca i percorsi di acquisizione aggiuntivi
`failproofai flush --wait`	Distribuisci lo spool di eventi corrente
`failproofai backfill --since 30d`	Rileggi la cronologia passata in precedenza
`failproofai config --pause [duration]`	Pausa una sessione locale per 30 minuti per impostazione predefinita, fino a 8 ore
`failproofai config --resume`	Riprendi una sessione locale messa in pausa; aggiungi `--all` per cancellare tutte le pause
`failproofai update`	Completa le migrazioni dei pacchetti e aggiorna il daemon
`failproofai migrate --dry-run`	Anteprima o esegui migrazioni del layout home in sospeso
`failproofai uninstall`	Rimuovi gli hook e il daemon prima di rimuovere il pacchetto
`failproofai --version`	Stampa la versione del pacchetto installato
`failproofai --help`	Mostra i comandi e l’uso globale

Flag di configurazione

Flag	Uso
`--connect <url> --token <key>`	Connetti in modo non interattivo
`--machine-id <id>`	Imposta l’ID macchina stabile
`--machine-label <name>`	Imposta o modifica l’etichetta del dashboard
`--no-transcripts`	Invia decisioni senza contenuto della trascrizione
`--disconnect`	Interrompi i pull delle politiche Cloud e la distribuzione degli eventi
`--status`	Mostra lo stato della macchina corrente
`--pause [duration]`	Metti in pausa la sessione più recente nella directory corrente; accetta secondi, minuti o ore e il valore predefinito è 30 minuti
`--resume`	Termina una pausa corrispondente in anticipo
`--session <id>`	Seleziona una sessione esplicita per la pausa o la ripresa
`--all`	Con `--resume`, termina ogni pausa attiva

Le pause locali sospendono le politiche integrate, personalizzate, convenzionali e pack per una sessione. Scadono sempre e non disabilitano le politiche gestite da Cloud. block-failproofai-commands — che è sempre attivo e non può essere disabilitato o messo in pausa — impedisce a un agente strumentato di usare questo meccanismo di fuga.

Flag delle politiche

Flag	Uso
`--install`, `-i`	Abilita le politiche e installa gli hook del harness
`--uninstall`, `-u`	Disabilita le politiche o rimuovi gli hook
`--cli <names...>`	Seleziona uno o più harness supportati
`--scope user\|project\|local\|all`	Scegli l’ambito della configurazione; `all` è per la disinstallazione
`--beta`	Includi le politiche beta
`--custom`, `-c <path>`	Convalida e carica un file di politica personalizzata; ripetibile

Flag di distribuzione e manutenzione

Comando	Flag
`backfill`	`--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run`
`flush`	`--wait`, `--timeout <seconds>`
`update`	`--no-daemon`
`migrate`	`--dry-run`
`uninstall`	`--purge`, `--dry-run`, `--yes`

failproofai update deve essere eseguito dopo npm install -g failproofai@latest; esegue migrazioni del layout home, installa il binario del daemon corrispondente e riavvia il servizio. --no-daemon esegue solo la migrazione del layout.

Percorsi del harness

failproofai harness list [harness]
failproofai harness add-path <harness> [label=]<path>
failproofai harness remove-path <harness> <path-or-label>

I nomi dei harness supportati sono claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity e goose. Le etichette classificano gli ID dell’agente derivato quando due root contengono copie dello stesso progetto. Le radici sovrapposte e le etichette duplicate vengono rifiutate per prevenire la raccolta duplicata o il danneggiamento del cursore. La configurazione del percorso aggiuntivo si ricarica senza un riavvio del daemon. Gli ambienti container possono sostituire i percorsi aggiuntivi configurati su file con una variabile separata da virgole denominata FAILPROOFAI_<HARNESS>_EXTRA_PATHS, ad esempio:

export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b"

Variabili d’ambiente

Usa file di configurazione per il comportamento persistente della macchina. Le variabili d’ambiente sono più utili per container, test e un singolo processo.

Variabile	Uso
`FAILPROOFAI_HOME`	Trasferisci il layout completo `~/.failproofai`
`FAILPROOFAI_LOG_LEVEL`	Imposta la verbosità della registrazione locale
`FAILPROOFAI_HOOK_LOG_FILE`	Scrivi la diagnostica degli hook in un file selezionato
`FAILPROOFAI_TELEMETRY_DISABLED=1`	Disabilita la telemetria anonima per questo processo
`FAILPROOFAI_NO_FIRST_RUN=1`	Salta la configurazione interattiva della prima esecuzione
`FAILPROOFAI_NO_AUTO_AUDIT=1`	Salta l’audit locale post-configurazione
`FAILPROOFAI_LLM_BASE_URL`	Sovrascrivi l’endpoint compatibile con OpenAI utilizzato dalle politiche LLM
`FAILPROOFAI_LLM_API_KEY`	Fornisci la chiave API utilizzata dalle politiche LLM
`FAILPROOFAI_LLM_MODEL`	Seleziona il modello utilizzato dalle politiche LLM
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	Limitare il caricamento del modulo di politica personalizzata
`FAILPROOFAI_NO_DOWNLOAD=1`	Rifiuta di scaricare pack e binari daemon; ciò che è installato continua a funzionare
`FAILPROOFAI_PACK_BASE_URL`	Scarica i pack da uno specchio invece di `github.com`
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	Sostituisci i percorsi di acquisizione aggiuntivi configurati per un harness
`NO_COLOR`	Disabilita l’output del terminale colorato

Le variabili home specifiche dell’agente come CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME e OPENCLAW_HOME sovrascrivono dove Failproof AI scopre le sessioni locali per quel harness.

Metti in pausa o rimuovi una macchina in sicurezza

failproofai config --pause
failproofai config --status
failproofai config --resume

Una pausa della sessione locale non disabilita le politiche gestite da Cloud. Ripristina le distribuzioni Cloud attraverso il flusso di lavoro di enforcement Cloud quando il rollout stesso è il problema. Prima di rimuovere il pacchetto npm, rimuovi gli hook installati e il daemon:

failproofai uninstall --dry-run
failproofai uninstall --yes
npm rm -g failproofai

Esegui failproofai <command> --help per i dettagli specifici della versione.

Esegui failproofai uninstall prima di npm rm -g failproofai; npm non rimuove gli hook dell’agente installati o il servizio daemon.

Connect your agents

Reference

Configura una macchina

Flag di configurazione

Flag delle politiche

Flag di distribuzione e manutenzione

Percorsi del harness

Variabili d’ambiente

Metti in pausa o rimuovi una macchina in sicurezza

​Configura una macchina

​Flag di configurazione

​Flag delle politiche

​Flag di distribuzione e manutenzione

​Percorsi del harness

​Variabili d’ambiente

​Metti in pausa o rimuovi una macchina in sicurezza

Configura una macchina

Flag di configurazione

Flag delle politiche

Flag di distribuzione e manutenzione

Percorsi del harness

Variabili d’ambiente

Metti in pausa o rimuovi una macchina in sicurezza