Vai al contenuto principale
Il dashboard di failproofai è un’applicazione web locale per monitorare le sessioni dei tuoi agenti AI e gestire le policy. Scopri cosa hanno fatto i tuoi agenti mentre non eri presente.

​
Avvio del dashboard

failproofai
Si apre su http://localhost:8020. Il dashboard legge direttamente dal filesystem - le cartelle del tuo progetto Claude Code e i file di configurazione di failproofai. Niente viene scritto su un servizio remoto.

​
Pagine

​
Progetti

Elenca tutti i progetti Claude Code trovati sul tuo computer. I progetti vengono individuati da ~/.claude/projects/ (o dal percorso impostato da CLAUDE_PROJECTS_PATH). Ogni progetto mostra:
  • Nome del progetto (derivato dal percorso della cartella)
  • Numero di sessioni
  • Data dell’attività della sessione più recente
Clicca su un progetto per vedere le sue sessioni.

​
Sessioni

Elenca tutte le sessioni all’interno di un progetto. Ogni sessione mostra:
  • ID della sessione
  • Timestamp di inizio e fine
  • Numero di chiamate di strumenti
  • Numero di attività hook (policy che si sono attivate)
Utilizza il filtro per intervallo di date e la ricerca per ID della sessione per restringere l’elenco. Le sessioni sono impaginate. Clicca su una sessione per aprire il visualizzatore di sessioni.

​
Visualizzatore di sessioni

Il visualizzatore di sessioni risponde alla domanda chiave per gli agenti autonomi: cosa ha fatto l’agente e ha mantenuto la giusta direzione? Mostra una sequenza temporale di tutto ciò che è accaduto in una sessione:
  • Messaggi - Risposte di testo di Claude e prompt dell’utente
  • Chiamate di strumenti - Ogni strumento invocato da Claude, con il suo input e output
  • Attività policy - Per ogni chiamata di strumento, quali policy si sono attivate e quale decisione hanno restituito
La barra delle statistiche in alto mostra la durata della sessione, il numero totale di chiamate di strumenti e un riepilogo delle decisioni degli hook (conteggi allow / deny / instruct). Puoi esportare la sessione come file ZIP o JSONL utilizzando il pulsante di download.

​
Policy

Una pagina con due schede per gestire le policy e revisionare l’attività.
  • Attiva o disattiva le singole policy con un solo clic (scrive in ~/.failproofai/policies-config.json)
  • Espandi una policy per configurare i suoi parametri (per le policy che supportano policyParams)
  • Installa o rimuovi hook per uno scope specifico
  • Imposta un percorso file di policy personalizzato

​
Aggiornamento automatico

Il dashboard ha un’opzione di aggiornamento automatico nella barra di navigazione in alto. Quando abilitata, la pagina corrente si aggiorna periodicamente per mostrare le nuove sessioni e l’attività delle policy man mano che appaiono. Essenziale per monitorare le sessioni di agenti autonomi a lunga esecuzione.

​
Disabilitazione di pagine

Se hai bisogno solo di alcune parti del dashboard, imposta FAILPROOFAI_DISABLE_PAGES a una lista separata da virgole di nomi di pagine: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
Valori validi: policies, projects.

​
Tema

Il dashboard supporta la modalità chiara e scura. Attiva/disattiva tramite il pulsante nella barra di navigazione. La preferenza viene memorizzata nell’archiviazione locale del tuo browser.

​
Configurazione del percorso dei progetti

Per impostazione predefinita, il dashboard legge dalla directory dei progetti Claude Code standard. Sostituiscila per configurazioni personalizzate: 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
Accesso da un host non-localhost

Quando esegui il dashboard in modalità dev (npm run dev) e vi accedi da un nome host diverso da localhost - ad esempio, un dominio personalizzato, un IP remoto o un URL tunnelato - potresti vedere un avviso come: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
Questo è Next.js che blocca l’accesso cross-origin al suo websocket HMR (hot module reload), una funzione solo per dev. Per consentire il tuo host, usa il flag --allowed-origins: 
npm run dev -- --allowed-origins dashboard.example.com
Per più host o IP, passa una lista separata da virgole: 
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
Puoi anche impostare la variabile di ambiente FAILPROOFAI_ALLOWED_DEV_ORIGINS: 
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
Questo si applica solo alla modalità dev. Quando esegui failproofai (modalità produzione), non c’è nessun websocket HMR e nessun problema di risorsa dev cross-origin.