Zum Hauptinhalt springen
Das failproofai Dashboard ist eine lokale Webanwendung zur Überwachung deiner KI-Agent-Sitzungen und zur Verwaltung von Richtlinien. Sieh nach, was deine Agents in deiner Abwesenheit gemacht haben.

​
Dashboard starten

failproofai
Öffnet sich unter http://localhost:8020. Das Dashboard liest direkt aus dem Dateisystem – aus deinen Claude Code Projektordnern und den failproofai Konfigurationsdateien. Es werden keine Daten an einen externen Dienst übertragen.

​
Seiten

​
Projekte

Listet alle Claude Code Projekte auf, die auf deinem Rechner gefunden wurden. Projekte werden aus ~/.claude/projects/ (oder dem über CLAUDE_PROJECTS_PATH festgelegten Pfad) eingelesen. Jedes Projekt zeigt:
  • Projektname (abgeleitet vom Ordnerpfad)
  • Anzahl der Sitzungen
  • Datum der letzten Sitzungsaktivität
Klicke auf ein Projekt, um dessen Sitzungen anzuzeigen.

​
Sitzungen

Listet alle Sitzungen innerhalb eines Projekts auf. Jede Sitzung zeigt:
  • Sitzungs-ID
  • Start- und Endzeitstempel
  • Anzahl der Tool-Aufrufe
  • Anzahl der Hook-Aktivitäten (ausgelöste Richtlinien)
Verwende den Datumsbereichsfilter und die Sitzungs-ID-Suche, um die Liste einzugrenzen. Sitzungen werden seitenweise angezeigt. Klicke auf eine Sitzung, um den Sitzungs-Viewer zu öffnen.

​
Sitzungs-Viewer

Der Sitzungs-Viewer beantwortet die zentrale Frage bei autonomen Agents: Was hat der Agent getan, und ist er auf Kurs geblieben? Er zeigt eine Zeitleiste aller Ereignisse einer Sitzung:
  • Nachrichten – Claudes Textantworten und Benutzeranfragen
  • Tool-Aufrufe – Jeder von Claude aufgerufene Tool, mit Eingabe und Ausgabe
  • Richtlinienaktivität – Für jeden Tool-Aufruf: welche Richtlinien ausgelöst wurden und welche Entscheidung sie zurückgegeben haben
Die Statistikleiste oben zeigt Sitzungsdauer, Gesamtanzahl der Tool-Aufrufe sowie eine Zusammenfassung der Hook-Entscheidungen (Anzahl allow / deny / instruct). Du kannst die Sitzung über den Download-Button als ZIP- oder JSONL-Datei exportieren.

​
Richtlinien

Eine Seite mit zwei Tabs zur Verwaltung von Richtlinien und zur Einsicht in Aktivitäten.
  • Einzelne Richtlinien per Klick aktivieren oder deaktivieren (schreibt in ~/.failproofai/policies-config.json)
  • Eine Richtlinie aufklappen, um ihre Parameter zu konfigurieren (für Richtlinien, die policyParams unterstützen)
  • Hooks für einen bestimmten Scope installieren oder entfernen
  • Einen benutzerdefinierten Pfad für die Richtliniendatei festlegen

​
Automatische Aktualisierung

Das Dashboard verfügt über einen Auto-Refresh-Schalter in der oberen Navigation. Wenn aktiviert, wird die aktuelle Seite regelmäßig aktualisiert, um neue Sitzungen und Richtlinienaktivitäten anzuzeigen, sobald sie auftreten. Unverzichtbar für die Überwachung langläufiger autonomer Agent-Sitzungen.

​
Seiten deaktivieren

Wenn du nur bestimmte Teile des Dashboards benötigst, setze FAILPROOFAI_DISABLE_PAGES auf eine kommagetrennte Liste von Seitennamen: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
Gültige Werte: policies, projects.

​
Design

Das Dashboard unterstützt hellen und dunklen Modus. Umschalten über den Button in der Navigationsleiste. Die Einstellung wird im lokalen Speicher deines Browsers gespeichert.

​
Projektpfad konfigurieren

Standardmäßig liest das Dashboard aus dem Standard-Claude Code Projektverzeichnis. Für individuelle Setups lässt sich dieser Pfad überschreiben: 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
Zugriff von einem Nicht-localhost-Host

Wenn du das Dashboard im Dev-Modus (npm run dev) ausführst und von einem anderen Hostnamen als localhost darauf zugreifst – beispielsweise einer benutzerdefinierten Domain, einer Remote-IP oder einer getunnelten URL – kann folgende Warnung erscheinen: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
Dabei blockiert Next.js den Cross-Origin-Zugriff auf seinen HMR-Websocket (Hot Module Reload), was ein ausschließlich im Dev-Modus vorhandenes Feature ist. Um deinen Host zuzulassen, verwende das Flag --allowed-origins: 
npm run dev -- --allowed-origins dashboard.example.com
Für mehrere Hosts oder IPs wird eine kommagetrennte Liste übergeben: 
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
Alternativ kann die Umgebungsvariable FAILPROOFAI_ALLOWED_DEV_ORIGINS gesetzt werden: 
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
Dies gilt ausschließlich für den Dev-Modus. Beim Ausführen von failproofai (Produktionsmodus) gibt es keinen HMR-Websocket und kein Cross-Origin-Problem mit Dev-Ressourcen.