> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Local dashboard

> Review local projects, sessions, policy activity, configuration, audits, and scheduled scans.

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

<Tabs>
  <Tab title="Dashboard">
    1. Open **Policies → Activity** and set the decision and source filters.
    2. Narrow by event, harness, tool, or policy name.
    3. Expand a row to inspect its reason, matched policies, source, execution mode, and duration.
    4. 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.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    failproofai config --status
    failproofai policies
    failproofai
    ```

    Local activity is stored under `~/.failproofai/hook-activity`. Use the dashboard instead of editing these files.
  </Tab>
</Tabs>

## Configure policies locally

<Tabs>
  <Tab title="Dashboard">
    1. Open **Policies → Configure** and choose the harnesses and configuration scope.
    2. Enable a builtin or discovered custom policy.
    3. For a parameterized builtin, open its configuration control and save supported values.
    4. 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.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    failproofai policy add block-sudo --scope project
    failproofai policies --install --custom ./security.policies.ts --scope project
    failproofai policies
    ```
  </Tab>
</Tabs>

## 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

<Tabs>
  <Tab title="Dashboard">
    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.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    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.
  </Tab>
</Tabs>

<Warning>
  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.
</Warning>