Failproof AI CLI

Installez le CLI local avec npm install -g failproofai. Lancez-le sans arguments pour ouvrir le tableau de bord des politiques locales. Le paquet nécessite Node.js 20.9 ou une version plus récente. Bun 1.3 ou une version plus récente est pris en charge pour le développement et les installations depuis les sources. failproofai configure et failproofai setup sont des alias de failproofai config ; failproofai p est un alias de failproofai policies.

Configurer une machine

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

Lancez failproofai sans arguments pour ouvrir le tableau de bord des politiques locales.

Commande	Résultat
`failproofai config`	Lance la configuration interactive de la machine
`failproofai config --connect <url> --token <key>`	Connecte l’ingestion Cloud et la distribution des politiques
`failproofai config --status`	Affiche l’état de la connexion, du daemon, de la distribution et de la pause
`failproofai policies`	Liste les politiques intégrées, personnalisées, conventionnelles, de pack et gérées par le Cloud
`failproofai policies --install`	Installe les hooks et active les politiques
`failproofai policy add <name>`	Active une politique — intégrée, ou `<pack-id>:<name>` depuis un pack installé
`failproofai policy remove <name>`	Désactive une politique, même convention de nommage
`failproofai policies --uninstall`	Désactive les politiques ou supprime les hooks du harnais
`failproofai pack list`	Liste les packs de politiques installés et toutes les politiques qu’ils contiennent
`failproofai pack add <source>`	Installe un pack de politiques depuis une release GitHub ; sans tag, prend la plus récente et l’épingle
`failproofai pack add --bundled`	Installe les politiques intégrées en tant que pack, depuis ce paquet, sans réseau
`failproofai pack build <entry.mjs>`	Construit les trois fichiers de release pour un pack personnalisé
`failproofai pack remove <publisher/name>`	Désactive un pack installé
`failproofai audit`	Analyse l’historique local de l’agent et ouvre la vue d’audit locale
`failproofai audit --schedule [days] --email <address>`	Planifie des analyses locales récurrentes et envoie leurs résultats par e-mail
`failproofai audit --status`	Affiche l’adresse de rapport, l’intervalle et la prochaine analyse planifiée
`failproofai audit --no-schedule`	Arrête les analyses récurrentes sans supprimer l’historique d’audit
`failproofai harness list`	Liste les chemins de capture supplémentaires
`failproofai flush --wait`	Livre le spool d’événements courant
`failproofai backfill --since 30d`	Relit l’historique précédemment parcouru
`failproofai config --pause [duration]`	Met en pause une session locale pendant 30 minutes par défaut, jusqu’à 8 heures
`failproofai config --resume`	Reprend une session locale en pause ; ajoutez `--all` pour effacer toutes les pauses
`failproofai update`	Finalise les migrations de paquet et met à jour le daemon
`failproofai migrate --dry-run`	Prévisualise ou exécute les migrations de disposition du répertoire personnel en attente
`failproofai uninstall`	Supprime les hooks et le daemon avant de désinstaller le paquet
`failproofai --version`	Affiche la version du paquet installé
`failproofai --help`	Affiche les commandes et l’utilisation globale

Options de configuration

Option	Utilisation
`--connect <url> --token <key>`	Connexion non interactive
`--machine-id <id>`	Définit l’identifiant stable de la machine
`--machine-label <name>`	Définit ou modifie le libellé du tableau de bord
`--no-transcripts`	Envoie les décisions sans le contenu des transcripts
`--disconnect`	Arrête les téléchargements de politiques Cloud et la livraison d’événements
`--status`	Affiche l’état courant de la machine
`--pause [duration]`	Met en pause la session la plus récente dans le répertoire courant ; accepte des secondes, minutes ou heures, par défaut 30 minutes
`--resume`	Termine une pause correspondante avant son expiration
`--session <id>`	Cible une session explicite pour la pause ou la reprise
`--all`	Avec `--resume`, termine toutes les pauses actives

Les pauses locales suspendent les politiques intégrées, personnalisées, conventionnelles et de pack pour une session. Elles expirent toujours et ne désactivent pas les politiques gérées par le Cloud. block-failproofai-commands — toujours activé et ne pouvant lui-même être désactivé ni mis en pause — empêche un agent instrumenté d’utiliser cette échappatoire.

Options des politiques

Option	Utilisation
`--install`, `-i`	Active les politiques et installe les hooks du harnais
`--uninstall`, `-u`	Désactive les politiques ou supprime les hooks
`--cli <names...>`	Cible un ou plusieurs harnais pris en charge
`--scope user\|project\|local\|all`	Choisit la portée de configuration ; `all` est réservé à la désinstallation
`--beta`	Inclut les politiques en version bêta
`--custom`, `-c <path>`	Valide et charge un fichier de politique personnalisé ; répétable

Options de livraison et de maintenance

Commande	Options
`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 doit être exécuté après npm install -g failproofai@latest ; il effectue les migrations de disposition du répertoire personnel, installe le binaire daemon correspondant et redémarre le service. --no-daemon effectue uniquement la migration de disposition.

Chemins du harnais

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

Les noms de harnais pris en charge sont claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity et goose. Les libellés permettent d’identifier les IDs d’agents dérivés lorsque deux racines contiennent des copies du même projet. Les racines qui se chevauchent et les libellés en double sont rejetés pour éviter les collectes en double ou la corruption du curseur. La configuration des chemins supplémentaires se recharge sans redémarrage du daemon. Les environnements conteneurisés peuvent remplacer les chemins supplémentaires configurés dans les fichiers par une variable séparée par des virgules nommée FAILPROOFAI_<HARNESS>_EXTRA_PATHS, par exemple :

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

Variables d’environnement

Utilisez les fichiers de configuration pour le comportement persistant de la machine. Les variables d’environnement sont surtout utiles pour les conteneurs, les tests et un seul processus.

Variable	Utilisation
`FAILPROOFAI_HOME`	Déplace l’ensemble de la disposition `~/.failproofai`
`FAILPROOFAI_LOG_LEVEL`	Définit le niveau de verbosité des journaux locaux
`FAILPROOFAI_HOOK_LOG_FILE`	Écrit les diagnostics des hooks dans le fichier sélectionné
`FAILPROOFAI_TELEMETRY_DISABLED=1`	Désactive la télémétrie anonyme pour ce processus
`FAILPROOFAI_NO_FIRST_RUN=1`	Ignore la configuration interactive au premier lancement
`FAILPROOFAI_NO_AUTO_AUDIT=1`	Ignore l’audit local post-configuration
`FAILPROOFAI_LLM_BASE_URL`	Remplace le point de terminaison compatible OpenAI utilisé par les politiques LLM
`FAILPROOFAI_LLM_API_KEY`	Fournit la clé API utilisée par les politiques LLM
`FAILPROOFAI_LLM_MODEL`	Sélectionne le modèle utilisé par les politiques LLM
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	Limite le temps de chargement des modules de politique personnalisés
`FAILPROOFAI_NO_DOWNLOAD=1`	Refuse de télécharger des packs et des binaires daemon ; ce qui est installé continue à s’appliquer
`FAILPROOFAI_PACK_BASE_URL`	Télécharge les packs depuis un miroir au lieu de `github.com`
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	Remplace les chemins de capture supplémentaires configurés pour un harnais
`NO_COLOR`	Désactive la sortie terminal en couleur

Les variables de répertoire personnel spécifiques à un agent, telles que CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME et OPENCLAW_HOME, remplacent l’emplacement où Failproof AI découvre les sessions locales pour ce harnais.

Mettre en pause ou retirer une machine en toute sécurité

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

La mise en pause d’une session locale ne désactive pas les politiques gérées par le Cloud. Restaurez les déploiements Cloud via le workflow d’application Cloud lorsque le déploiement lui-même pose problème. Avant de supprimer le paquet npm, supprimez les hooks installés et le daemon :

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

Lancez failproofai <command> --help pour des détails spécifiques à votre version.

Exécutez failproofai uninstall avant npm rm -g failproofai ; npm ne supprime pas les hooks d’agent installés ni le service daemon.

Connect your agents

Reference

Configurer une machine

Options de configuration

Options des politiques

Options de livraison et de maintenance

Chemins du harnais

Variables d’environnement

Mettre en pause ou retirer une machine en toute sécurité

​Configurer une machine

​Options de configuration

​Options des politiques

​Options de livraison et de maintenance

​Chemins du harnais

​Variables d’environnement

​Mettre en pause ou retirer une machine en toute sécurité

Configurer une machine

Options de configuration

Options des politiques

Options de livraison et de maintenance

Chemins du harnais

Variables d’environnement

Mettre en pause ou retirer une machine en toute sécurité