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

# Dashboard Overview

> Your auto-sop command center — stats, gains charts, license key, projects, and directive summary at a glance.

# Dashboard Overview

The dashboard is your auto-sop command center. It shows aggregate stats, gains over time, and a summary of your active directives — all in one place.

## First visit — Onboarding

When you first sign in with zero projects bound, the dashboard shows an **onboarding flow** with a QuickStart card:

<Steps>
  <Step title="Copy your license key">
    Your unique license key is displayed at the top of the dashboard. Copy it with one click.
  </Step>

  <Step title="Install in your project">
    Run the install command in your project directory:

    ```bash theme={null}
    auto-sop install --license YOUR_LICENSE_KEY
    ```
  </Step>

  <Step title="Use Claude Code normally">
    Start a Claude Code session. auto-sop captures interactions automatically.
  </Step>

  <Step title="Dashboard populates">
    Once the CLI syncs metrics, your dashboard fills with real data.
  </Step>
</Steps>

## Stats grid

After binding your first project, the dashboard displays a **stats grid** with key metrics:

| Metric                | What it measures                                                     |
| --------------------- | -------------------------------------------------------------------- |
| **Projects Bound**    | Active projects linked to your license (Free: 1 max, Pro: unlimited) |
| **Active Directives** | Total directives across all projects                                 |
| **Errors Prevented**  | Times a directive fired and prevented a recurring mistake            |
| **Tokens Saved**      | Estimated tokens saved by preventing repeated mistakes               |

Projects that haven't had recent Claude Code activity show their last-known stats in the grid. Inactive project metrics remain visible until the project is unbound.

<Tip>
  Stats update automatically when the CLI syncs metrics during regular learner runs. You can also trigger a manual sync with `auto-sop learn-now`.
</Tip>

## Directive summary

Once your projects have directive-fire data, a **Directive Summary** card appears showing:

* **Total fires** — how many times any directive has been triggered across all projects
* **Top 5 directives** — the most frequently firing directives with their preview text
* **Active directive count** — total unique directives across bound projects

<Info>
  Only the first 10 words of each directive are synced to the cloud. Full directive text stays on your machine.
</Info>

## Your Gains — charts

The **Your Gains** section displays two time-series charts:

<CardGroup cols={2}>
  <Card title="Tokens Saved" icon="coins">
    Track cumulative token savings over time. Shows how many tokens auto-sop has saved by preventing repeated mistakes.
  </Card>

  <Card title="Errors Prevented" icon="shield-check">
    Track errors prevented over time. Every time a directive fires successfully, it counts as a prevented error.
  </Card>
</CardGroup>

## Projects list

Below the charts, a compact **Projects List** shows each bound project with its slug, status, and quick stats. Click any project to see detailed metrics.

## First directive celebration

When your first directive fires across any project, a **celebration banner** appears to mark the milestone. This confirms auto-sop is actively learning from your workflow.

## How data flows

```
Claude Code session
  └─ auto-sop hook captures tool calls
       └─ Learner analyzes captures (automatic or on-demand)
            └─ CLI syncs aggregate stats to cloud (Pro)
                 └─ Dashboard refreshes with latest data
```

<Tip>
  All users — including free-tier — get stats synced to the dashboard for their bound project. Pro users unlock unlimited projects, charts, and directive previews.
</Tip>