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

# Viewing Directives

> Browse synced directives across all your projects — previews, fire counts, and filtering by project.

# Viewing Directives

The Directives page shows every synced directive across all your bound projects, grouped by project with fire counts and preview text.

<Warning>
  Directive sync is a **Pro feature**. Free-tier users see a teaser with a prompt to upgrade.
</Warning>

## What you see

For each directive, the dashboard displays:

| Column           | Description                                                   |
| ---------------- | ------------------------------------------------------------- |
| **Directive ID** | The unique identifier (e.g., `sop-70ad`)                      |
| **Preview**      | First 10 words of the directive text                          |
| **Hits**         | Number of confirmed fires — times the directive was triggered |

Directives are **grouped by project** and sorted by fire count (highest first) within each group.

## Privacy — what syncs

<Info>
  Only the **first 10 words** of each directive are synced to the cloud. The full directive text, raw captures, and session data stay on your machine.
</Info>

The cloud receives:

* Directive ID
* First 10 words (preview)
* Aggregate fire count
* Project slug

The cloud **never** receives:

* Full directive text
* Raw captures or tool calls
* Session transcripts
* Source code

## Filtering by project

When you have multiple projects, a **project filter** dropdown appears at the top of the page. Use it to view directives from a specific project or all projects at once.

The total directive count updates dynamically as you filter.

## How directives sync

Directives sync to the cloud during the regular CLI stats sync cycle:

<Steps>
  <Step title="Learner runs">
    The learner (triggered automatically during your session or via `auto-sop learn-now`) analyzes captures and writes directives to CLAUDE.md.
  </Step>

  <Step title="Stats sync">
    The CLI sends aggregate stats — including directive previews and fire counts — to the cloud.
  </Step>

  <Step title="Dashboard updates">
    The Directives page pulls the latest synced data on each page load.
  </Step>
</Steps>

## Empty state

If you're on Pro/Trial but no directives have synced yet, you'll see an empty state prompting you to ensure the CLI is up to date and has run at least one learning cycle.

<Tip>
  Trigger an immediate sync with `auto-sop learn-now` to populate directives without waiting for the next automatic run.
</Tip>
