Skip to main content
The failproofai dashboard is a local web application for monitoring your AI agent sessions and managing policies. See what your agents did while you were away.

​
Starting the dashboard

failproofai
Opens at http://localhost:8020. The dashboard reads directly from the filesystem - your Claude Code project folders and the failproofai config files. Nothing is written to a remote service.

​
Pages

​
Projects

Lists all Claude Code projects found on your machine. Projects are discovered from ~/.claude/projects/ (or the path set by CLAUDE_PROJECTS_PATH). Each project shows:
  • Project name (derived from the folder path)
  • Number of sessions
  • Date of most recent session activity
Click a project to see its sessions.

​
Sessions

Lists all sessions within a project. Each session shows:
  • Session ID
  • Start and end timestamps
  • Number of tool calls
  • Hook activity count (policies that fired)
Use the date range filter and session ID search to narrow the list. Sessions are paginated. Click a session to open the session viewer.

​
Session viewer

The session viewer answers the key question for autonomous agents: what did the agent do, and did it stay on track? It shows a timeline of everything that happened in a session:
  • Messages - Claude’s text responses and user prompts
  • Tool calls - Every tool Claude invoked, with its input and output
  • Policy activity - For each tool call, which policies fired and what decision they returned
The stats bar at the top shows session duration, total tool calls, and a summary of hook decisions (allow / deny / instruct counts). You can export the session as a ZIP or JSONL file using the download button.

​
Policies

A two-tab page for managing policies and reviewing activity.
  • Toggle individual policies on or off with a single click (writes to ~/.failproofai/policies-config.json)
  • Expand a policy to configure its parameters (for policies that support policyParams)
  • Install or remove hooks for a given scope
  • Set a custom hooks file path

​
Auto-refresh

The dashboard has an auto-refresh toggle in the top navigation. When enabled, the current page refreshes periodically to show new sessions and policy activity as they appear. Essential for monitoring long-running autonomous agent sessions.

​
Disabling pages

If you only need some parts of the dashboard, set FAILPROOFAI_DISABLE_PAGES to a comma-separated list of page names: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
Valid values: policies, projects.

​
Theme

The dashboard supports light and dark mode. Toggle via the button in the navigation bar. The preference is stored in your browser’s local storage.

​
Configuring the projects path

By default, the dashboard reads from the standard Claude Code projects directory. Override it for custom setups: 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
Accessing from a non-localhost host

When running the dashboard in dev mode (npm run dev) and accessing it from a hostname other than localhost - for example, a custom domain, a remote IP, or a tunneled URL - you may see a warning like: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
This is Next.js blocking cross-origin access to its HMR (hot module reload) websocket, which is a dev-only feature. To allow your host, use the --allowed-origins flag: 
npm run dev -- --allowed-origins dashboard.example.com
For multiple hosts or IPs, pass a comma-separated list: 
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
You can also set the FAILPROOFAI_ALLOWED_DEV_ORIGINS environment variable instead: 
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
This only applies to dev mode. When running failproofai (production mode), there is no HMR websocket and no cross-origin dev resource issue.