Quickstart - Failproof AI

Dieser Quickstart sorgt dafür, dass eine Maschine Sitzungen meldet, führt ein Audit durch und stellt eine Richtlinie bereit. Nutze dazu den Skill oder folge den manuellen Schritten. Du benötigst Node.js 20.9 oder neuer.

Skill verwenden
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 aus, 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 übermittelt. Füge --no-transcripts hinzu, um Hook-Aktivitäten und Richtlinienentscheidungen ohne Transkriptinhalt zu melden.Wenn diese Maschine bereits Agentenhistorie besitzt, kannst du die letzten sieben Tage vorab anzeigen und importieren — warte anschließend, bis die Übertragung abgeschlossen ist. Auf einer neuen Maschine kannst du diesen Schritt überspringen.

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 deine Agenten-CLI angebunden und die integrierten Richtlinien werden installiert. Nutze sie, um lokale Richtlinienentscheidungen einzusehen und die Durchsetzung auszuprobieren, bevor Failproof AI deine Sitzungen prüft und Richtlinien für deine Agenten erstellt.Lass den Installer deine Agenten-CLI automatisch erkennen oder gib sie explizit an.

failproofai policies --install --cli claude --scope user

Verhalten prüfen

Folge der Anleitung unter Erste Fehlerprüfung durchführen. Verwende ein konkretes Ziel, z. B. „Sitzungen finden, in denen der Agent ein fehlgeschlagenes Tool ohne Änderung seines Vorgehens erneut ausgeführt hat.”

Fehler verhindern

Folge der Anleitung unter Ersten Fehler mit einer Richtlinie verhindern. Beginne im Beobachtungsmodus, prüfe Treffer und setze dann die überprüfte Version durch.

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