Failproof AI CLI

Installieren Sie die lokale CLI mit npm install -g failproofai. Ohne Argumente aufgerufen öffnet sie das lokale Richtlinien-Dashboard. Das Paket erfordert Node.js 20.9 oder neuer. Bun 1.3 oder neuer wird für Entwicklungs- und Quellinstallationen unterstützt. failproofai configure und failproofai setup sind Aliase für failproofai config; failproofai p ist ein Alias für failproofai policies.

Eine Maschine einrichten

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

Führen Sie failproofai ohne Argumente aus, um das lokale Richtlinien-Dashboard zu öffnen.

Befehl	Ergebnis
`failproofai config`	Interaktive Maschineneinrichtung starten
`failproofai config --connect <url> --token <key>`	Cloud-Erfassung und Richtlinienverteilung verbinden
`failproofai config --status`	Verbindungs-, Daemon-, Liefer- und Pausenstatus anzeigen
`failproofai policies`	Eingebaute, benutzerdefinierte, konventionelle, Pack- und Cloud-verwaltete Richtlinien auflisten
`failproofai policies --install`	Hooks installieren und Richtlinien aktivieren
`failproofai policy add <name>`	Eine Richtlinie aktivieren – eine eingebaute oder `<pack-id>:<name>` aus einem installierten Pack
`failproofai policy remove <name>`	Eine Richtlinie deaktivieren, gleiche Benennung
`failproofai policies --uninstall`	Richtlinien deaktivieren oder Harness-Hooks entfernen
`failproofai pack list`	Installierte Richtlinien-Packs und alle enthaltenen Richtlinien auflisten
`failproofai pack add <source>`	Ein Richtlinien-Pack von einem GitHub-Release installieren; ohne Tag wird die neueste Version genommen und angeheftet
`failproofai pack add --bundled`	Die eingebauten Richtlinien als Pack installieren, aus diesem Paket, ohne Netzwerk
`failproofai pack build <entry.mjs>`	Die drei Release-Assets für ein eigenes Pack erstellen
`failproofai pack remove <publisher/name>`	Ein installiertes Pack deaktivieren
`failproofai audit`	Lokalen Agent-Verlauf scannen und die lokale Audit-Ansicht öffnen
`failproofai audit --schedule [days] --email <address>`	Wiederkehrende lokale Scans planen und deren Ergebnisse per E-Mail versenden
`failproofai audit --status`	Berichtsadresse, Intervall und nächsten geplanten Scan anzeigen
`failproofai audit --no-schedule`	Wiederkehrende Scans stoppen, ohne den Audit-Verlauf zu löschen
`failproofai harness list`	Zusätzliche Erfassungspfade auflisten
`failproofai flush --wait`	Die aktuelle Ereigniswarteschlange übertragen
`failproofai backfill --since 30d`	Zuvor verarbeiteten Verlauf erneut einlesen
`failproofai config --pause [duration]`	Eine lokale Sitzung für standardmäßig 30 Minuten pausieren, bis zu 8 Stunden
`failproofai config --resume`	Eine pausierte lokale Sitzung fortsetzen; `--all` hinzufügen, um alle Pausen aufzuheben
`failproofai update`	Paket-Migrationen abschließen und den Daemon aktualisieren
`failproofai migrate --dry-run`	Ausstehende Home-Layout-Migrationen in der Vorschau anzeigen oder ausführen
`failproofai uninstall`	Hooks und den Daemon entfernen, bevor das Paket deinstalliert wird
`failproofai --version`	Die installierte Paketversion ausgeben
`failproofai --help`	Befehle und allgemeine Nutzung anzeigen

Konfigurationsflags

Flag	Verwendung
`--connect <url> --token <key>`	Nicht-interaktiv verbinden
`--machine-id <id>`	Die stabile Maschinen-ID festlegen
`--machine-label <name>`	Das Dashboard-Label setzen oder ändern
`--no-transcripts`	Entscheidungen ohne Transkriptinhalt senden
`--disconnect`	Cloud-Richtlinienabfragen und Ereignisübertragung stoppen
`--status`	Aktuellen Maschinenstatus anzeigen
`--pause [duration]`	Die neueste Sitzung im aktuellen Verzeichnis pausieren; akzeptiert Sekunden, Minuten oder Stunden, Standardwert 30 Minuten
`--resume`	Eine passende Pause vorzeitig beenden
`--session <id>`	Eine explizite Sitzung für Pause oder Fortsetzen auswählen
`--all`	Mit `--resume`: alle aktiven Pausen beenden

Lokale Pausen setzen eingebaute, benutzerdefinierte, konventionelle und Pack-Richtlinien für eine Sitzung aus. Sie laufen immer ab und deaktivieren keine Cloud-verwalteten Richtlinien. block-failproofai-commands – das immer aktiv ist und selbst weder deaktiviert noch pausiert werden kann – verhindert, dass ein instrumentierter Agent diesen Ausweg selbst nutzt.

Richtlinienflags

Flag	Verwendung
`--install`, `-i`	Richtlinien aktivieren und Harness-Hooks installieren
`--uninstall`, `-u`	Richtlinien deaktivieren oder Hooks entfernen
`--cli <names...>`	Einen oder mehrere unterstützte Harnesses auswählen
`--scope user\|project\|local\|all`	Den Konfigurationsbereich wählen; `all` ist für die Deinstallation
`--beta`	Beta-Richtlinien einschließen
`--custom`, `-c <path>`	Eine benutzerdefinierte Richtliniendatei validieren und laden; wiederholbar

Übertragungs- und Wartungsflags

Befehl	Flags
`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 sollte nach npm install -g failproofai@latest ausgeführt werden; es führt Home-Layout-Migrationen durch, installiert das passende Daemon-Binary und startet den Dienst neu. --no-daemon führt nur die Layout-Migration durch.

Harness-Pfade

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

Unterstützte Harness-Namen sind claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity und goose. Labels vergeben Namensräume für abgeleitete Agent-IDs, wenn zwei Wurzeln Kopien desselben Projekts enthalten. Überlappende Wurzeln und doppelte Labels werden abgelehnt, um doppelte Erfassung oder Cursor-Beschädigung zu verhindern. Die Konfiguration von Extra-Pfaden wird ohne Daemon-Neustart neu geladen. Container-Umgebungen können dateibasierte Extra-Pfade durch eine kommagetrennte Variable namens FAILPROOFAI_<HARNESS>_EXTRA_PATHS ersetzen, zum Beispiel:

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

Umgebungsvariablen

Verwenden Sie Konfigurationsdateien für dauerhaftes Maschinenverhalten. Umgebungsvariablen sind am nützlichsten für Container, Tests und einzelne Prozesse.

Variable	Verwendung
`FAILPROOFAI_HOME`	Das vollständige `~/.failproofai`-Layout verschieben
`FAILPROOFAI_LOG_LEVEL`	Lokale Logging-Ausführlichkeit festlegen
`FAILPROOFAI_HOOK_LOG_FILE`	Hook-Diagnosemeldungen in eine ausgewählte Datei schreiben
`FAILPROOFAI_TELEMETRY_DISABLED=1`	Anonyme Telemetrie für diesen Prozess deaktivieren
`FAILPROOFAI_NO_FIRST_RUN=1`	Interaktive Ersteinrichtung überspringen
`FAILPROOFAI_NO_AUTO_AUDIT=1`	Lokalen Audit nach der Einrichtung überspringen
`FAILPROOFAI_LLM_BASE_URL`	Den von LLM-Richtlinien verwendeten OpenAI-kompatiblen Endpunkt überschreiben
`FAILPROOFAI_LLM_API_KEY`	Den von LLM-Richtlinien verwendeten API-Schlüssel bereitstellen
`FAILPROOFAI_LLM_MODEL`	Das von LLM-Richtlinien verwendete Modell auswählen
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	Ladezeit benutzerdefinierter Richtlinien-Module begrenzen
`FAILPROOFAI_NO_DOWNLOAD=1`	Abruf von Packs und Daemon-Binaries verweigern; bereits Installiertes bleibt aktiv
`FAILPROOFAI_PACK_BASE_URL`	Packs von einem Mirror statt von `github.com` abrufen
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	Konfigurierte Extra-Erfassungspfade für einen Harness ersetzen
`NO_COLOR`	Farbige Terminalausgabe deaktivieren

Agent-spezifische Home-Variablen wie CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME und OPENCLAW_HOME überschreiben, wo Failproof AI lokale Sitzungen für den jeweiligen Harness erkennt.

Eine Maschine sicher pausieren oder entfernen

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

Eine lokale Sitzungspause deaktiviert keine Cloud-verwalteten Richtlinien. Stellen Sie Cloud-Deployments über den Cloud-Durchsetzungs-Workflow wieder her, wenn das Rollout selbst das Problem ist. Bevor Sie das npm-Paket entfernen, deinstallieren Sie installierte Hooks und den Daemon:

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

Führen Sie failproofai <command> --help aus, um versionsspezifische Details zu erhalten.

Führen Sie failproofai uninstall vor npm rm -g failproofai aus; npm entfernt weder installierte Agent-Hooks noch den Daemon-Dienst.

Connect your agents

Reference

Eine Maschine einrichten

Konfigurationsflags

Richtlinienflags

Übertragungs- und Wartungsflags

Harness-Pfade

Umgebungsvariablen

Eine Maschine sicher pausieren oder entfernen

​Eine Maschine einrichten

​Konfigurationsflags

​Richtlinienflags

​Übertragungs- und Wartungsflags

​Harness-Pfade

​Umgebungsvariablen

​Eine Maschine sicher pausieren oder entfernen

Eine Maschine einrichten

Konfigurationsflags

Richtlinienflags

Übertragungs- und Wartungsflags

Harness-Pfade

Umgebungsvariablen

Eine Maschine sicher pausieren oder entfernen