Local dashboard

Run failproofai without arguments to start the bundled dashboard at http://localhost:8020. It reads local agent histories, policy configuration, audit results, and hook activity directly from the machine. The local dashboard is separate from Failproof AI Cloud. It works without a Cloud account and does not prove that events were delivered to your organization.

Dashboard areas

Area	What you can accomplish
Policies → Activity	Inspect local allow, instruct, and deny decisions; filter by decision, event, CLI, tool, source, policy, and session.
Policies → Configure	Enable builtins, edit supported parameters, toggle discovered custom policies, and select target harnesses.
Projects	Browse discovered projects across supported agent histories and compare their most recent sessions.
Project sessions	Open one local transcript, review raw ordered entries and subagents, download it, and correlate policy activity.
Audit	Review the last offline scan, risky patterns, strengths, affected projects, and suggested builtin policies.
Settings	Configure scheduled local scans and emailed audit reports when the daemon/platform supports them.

Review policy activity

Dashboard
CLI

Open Policies → Activity and set the decision and source filters.
Narrow by event, harness, tool, or policy name.
Expand a row to inspect its reason, matched policies, source, execution mode, and duration.
Follow the session link to place the decision in transcript context.

A denied-looking row can still be observational on a harness/event pair that does not consume blocking verdicts. The detail view calls out verified enforcement capability.

failproofai config --status
failproofai policies
failproofai

Local activity is stored under ~/.failproofai/hook-activity. Use the dashboard instead of editing these files.

Configure policies locally

Dashboard
CLI

Open Policies → Configure and choose the harnesses and configuration scope.
Enable a builtin or discovered custom policy.
For a parameterized builtin, open its configuration control and save supported values.
Return to Activity and run matching and non-matching actions.

Convention policies show their project or user source. Explicit custom-path changes may require rerunning CLI configuration so the selected path is recorded.

failproofai policy add block-sudo --scope project
failproofai policies --install --custom ./security.policies.ts --scope project
failproofai policies

Browse projects and sessions

The Projects page combines supported local history stores. Select a project to list its sessions, then open a session for the raw log viewer, subagent segments, download action, and session-scoped policy activity. If a project or session is missing, confirm the harness uses its default history location or register an extra root with failproofai harness add-path.

Schedule offline audits

Dashboard
CLI

Open Settings, enable scheduled scanning, choose its supported interval, and configure report delivery when available. The page reports the next run, last run, exit code, and whether the background daemon is supported on the platform.

failproofai audit --schedule 7 --email reliability@example.com
failproofai audit --status

Change the number of days to set a different 1–90 day interval. Disable recurring scans with failproofai audit --no-schedule; run failproofai audit for an immediate interactive scan.

The local dashboard can display prompts, tool input, file content, and terminal output from local agent histories. Bind it only to trusted interfaces and stop the process when review is complete.

Connect your agents

Reference

HTTP API

Dashboard areas

Review policy activity

Configure policies locally

Browse projects and sessions

Schedule offline audits

​Dashboard areas

​Review policy activity

​Configure policies locally

​Browse projects and sessions

​Schedule offline audits

Dashboard areas

Review policy activity

Configure policies locally

Browse projects and sessions

Schedule offline audits