Passer au contenu principal
Le tableau de bord failproofai est une application web locale permettant de surveiller les sessions de vos agents IA et de gérer les politiques. Voyez ce que vos agents ont fait pendant votre absence.

​
Démarrer le tableau de bord

failproofai
S’ouvre à l’adresse http://localhost:8020. Le tableau de bord lit directement depuis le système de fichiers — vos dossiers de projets Claude Code et les fichiers de configuration failproofai. Aucune donnée n’est envoyée vers un service distant.

​
Pages

​
Projets

Liste tous les projets Claude Code trouvés sur votre machine. Les projets sont découverts depuis ~/.claude/projects/ (ou le chemin défini par CLAUDE_PROJECTS_PATH). Chaque projet affiche :
  • Le nom du projet (dérivé du chemin du dossier)
  • Le nombre de sessions
  • La date de la dernière activité de session
Cliquez sur un projet pour voir ses sessions.

​
Sessions

Liste toutes les sessions d’un projet. Chaque session affiche :
  • L’identifiant de session
  • Les horodatages de début et de fin
  • Le nombre d’appels d’outils
  • Le nombre d’activités de hook (politiques déclenchées)
Utilisez le filtre par plage de dates et la recherche par identifiant de session pour affiner la liste. Les sessions sont paginées. Cliquez sur une session pour ouvrir le visualiseur de session.

​
Visualiseur de session

Le visualiseur de session répond à la question clé pour les agents autonomes : qu’a fait l’agent, et est-il resté sur la bonne voie ? Il affiche une chronologie de tout ce qui s’est passé lors d’une session :
  • Messages - Les réponses textuelles de Claude et les invites de l’utilisateur
  • Appels d’outils - Chaque outil invoqué par Claude, avec ses entrées et sorties
  • Activité des politiques - Pour chaque appel d’outil, quelles politiques ont été déclenchées et quelle décision elles ont rendue
La barre de statistiques en haut affiche la durée de la session, le nombre total d’appels d’outils et un résumé des décisions de hook (compteurs allow / deny / instruct). Vous pouvez exporter la session sous forme de fichier ZIP ou JSONL à l’aide du bouton de téléchargement.

​
Politiques

Une page à deux onglets pour gérer les politiques et consulter l’activité.
  • Activez ou désactivez individuellement les politiques d’un simple clic (écrit dans ~/.failproofai/policies-config.json)
  • Développez une politique pour configurer ses paramètres (pour les politiques qui prennent en charge policyParams)
  • Installez ou supprimez des hooks pour un scope donné
  • Définissez un chemin personnalisé vers un fichier de politiques

​
Actualisation automatique

Le tableau de bord dispose d’un bouton d’actualisation automatique dans la navigation supérieure. Lorsqu’il est activé, la page courante se rafraîchit périodiquement pour afficher les nouvelles sessions et l’activité des politiques au fur et à mesure qu’elles apparaissent. Indispensable pour surveiller des sessions d’agents autonomes de longue durée.

​
Désactiver des pages

Si vous n’avez besoin que de certaines parties du tableau de bord, définissez FAILPROOFAI_DISABLE_PAGES avec une liste de noms de pages séparés par des virgules : 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
Valeurs valides : policies, projects.

​
Thème

Le tableau de bord prend en charge les modes clair et sombre. Basculez entre les deux via le bouton dans la barre de navigation. La préférence est enregistrée dans le stockage local de votre navigateur.

​
Configurer le chemin des projets

Par défaut, le tableau de bord lit depuis le répertoire standard des projets Claude Code. Remplacez-le pour des configurations personnalisées : 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
Accès depuis un hôte autre que localhost

Lorsque vous exécutez le tableau de bord en mode développement (npm run dev) et que vous y accédez depuis un nom d’hôte autre que localhost — par exemple, un domaine personnalisé, une IP distante ou une URL tunnelisée — vous pouvez voir un avertissement du type : 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
Il s’agit de Next.js qui bloque l’accès cross-origin à son websocket HMR (rechargement à chaud des modules), une fonctionnalité réservée au développement. Pour autoriser votre hôte, utilisez le flag --allowed-origins : 
npm run dev -- --allowed-origins dashboard.example.com
Pour plusieurs hôtes ou adresses IP, passez une liste séparée par des virgules : 
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
Vous pouvez également définir la variable d’environnement FAILPROOFAI_ALLOWED_DEV_ORIGINS à la place : 
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
Ceci s’applique uniquement au mode développement. Lors de l’exécution de failproofai (mode production), il n’y a pas de websocket HMR ni de problème de ressource cross-origin en développement.