Quickstart - Failproof AI

Dieser Quickstart verbindet eine Maschine mit der Sitzungserfassung, führt ein Audit durch und stellt eine Richtlinie bereit. Nutze die Skill-basierte Einrichtung oder folge den manuellen Schritten. Welcher Weg passt zu dir? Wenn dein Agent in einem der 12 unterstützten Harnesses läuft — einer Coding-CLI oder einem Gateway wie Hermes oder OpenClaw — folge den nachstehenden Schritten; du benötigst Node.js 20.9 oder höher. Wenn dein Agent kein Harness hat, instrumentiere ihn mit dem Python SDK für Tracing und Audits, und steige dann bei Ersten Fehlercheck ausführen wieder ein; die Durchsetzung erfordert auf diesem Weg einen Hook in deiner Laufzeitumgebung.

Mit der Skill nutzen
Manuelle Einrichtung

Failproof AI Skills installieren

npx skills add FailproofAI/skills

Agent alles einrichten lassen

Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.

Dein Agent analysiert das Projekt, wählt die passende Integration, führt die Einrichtung durch und verifiziert sie. Einzelne Skills und erweiterte Installationsoptionen findest du im FailproofAI Skills-Repository.

Bevor du beginnst

Öffne das Failproof AI Dashboard und erstelle ein Konto oder melde dich mit deiner Arbeits-E-Mail an.
Gehe zu Administration → Keys und erstelle einen Schlüssel mit events:add und policies:pull.
Kopiere das einmalige Secret und speichere es auf der Zielmaschine:

export FAILPROOFAI_KEY="<one-time-secret>"

Installation

Failproof AI installieren und verbinden

npm install -g failproofai
failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY"

Sitzungstranskripte werden standardmäßig übertragen. Füge --no-transcripts hinzu, um nur Hook-Aktivitäten und Richtlinienentscheidungen ohne Transkriptinhalt zu melden.Wenn diese Maschine bereits einen Agentenverlauf hat, kannst du die letzten sieben Tage vorab anzeigen und importieren — warte anschließend, bis die Übertragung abgeschlossen ist. Überspringe diesen Schritt bei einer neuen Maschine.

failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d
failproofai flush --wait

Öffne Sessions in Failproof AI und wähle eine importierte Sitzung aus.

Agent-Hooks und Richtlinien installieren

Damit wird Failproof AI an dein Harness angebunden und die 39 integrierten Richtlinien werden installiert. Nutze sie, um lokale Richtlinienentscheidungen einzusehen und die Durchsetzung auszuprobieren, bevor Failproof AI deine Sitzungen auditiert und Richtlinien für deine Agenten erstellt.Lass den Installer dein Harness automatisch erkennen oder gib eines explizit an. Alle 12 sind gültige --cli-Werte — claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, goose.

failproofai policies --install --cli claude --scope user     # eine Coding-CLI
failproofai policies --install --cli hermes --scope user     # ein Slack/Telegram-Gateway

Das Blockieren eines Tool-Aufrufs vor dessen Ausführung ist auf allen 12 verifiziert. Turn-End-Gates sind auf 8 verifiziert — die harness-spezifische Matrix findest du unter Durchsetzungsfähigkeit.

Verhalten auditieren

Folge Ersten Fehlercheck ausführen. Verwende ein konkretes Ziel, z. B. „Sitzungen finden, in denen der Agent ein fehlschlagendes Tool ohne Änderung des Ansatzes erneut versucht hat.”

Fehler verhindern

Folge Ersten Fehler mit einer Richtlinie verhindern. Beginne im Beobachtungsmodus, prüfe Treffer und erzwinge dann die überprüfte Version.

Führe failproofai config --status aus. Eine funktionierende Einrichtung meldet die Cloud-Verbindung, den Daemon-Status und ob die Durchsetzung pausiert ist.

​Bevor du beginnst

​Installation

Bevor du beginnst

Installation