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

# Quickstart

> Install auto-sop and get your first enforced directive in 5 minutes.

# Quickstart

From install to your first directive in 5 minutes.

## System requirements

| Requirement | Version                  |
| ----------- | ------------------------ |
| Node.js     | >= 18.17                 |
| OS          | macOS, Linux, or Windows |
| Claude Code | >= 2.1.107               |

<Steps>
  <Step title="Install the CLI">
    Run the installer from your project directory:

    ```bash theme={null}
    npx auto-sop install
    ```

    Or install via Homebrew (macOS/Linux):

    ```bash theme={null}
    brew install auto-sop/tap/auto-sop
    auto-sop install
    ```

    The installer configures hooks, the event-driven learner with a daily sweep, and the managed section in `CLAUDE.md`.

    ```
    ✔ Hook shim installed (.auto-sop/hooks/)
    ✔ Daily sweep registered (launchd/systemd)
    ✔ Managed section added to CLAUDE.md
    ✔ Ready — captures will begin on next Claude Code session
    ```
  </Step>

  <Step title="Use Claude Code normally">
    Just keep working as usual. auto-sop captures tool calls silently in the background with less than 50ms overhead.

    ```bash theme={null}
    claude  # start a session — captures happen automatically
    ```

    <Info>
      Captures are stored locally in `.auto-sop/captures/` — they never leave your machine on the free tier.
    </Info>
  </Step>

  <Step title="Trigger learning">
    The learner runs automatically during your session and once daily. To trigger it immediately:

    ```bash theme={null}
    auto-sop learn-now
    ```

    The learner analyzes your captures, finds recurring patterns (3+ occurrences), and validates them with LLM analysis.

    ```
    ✔ Analyzed 47 captures
    ✔ Found 3 candidate patterns
    ✔ Validated 2 directives via LLM
    ✔ Wrote 2 new directives to CLAUDE.md
    ```
  </Step>

  <Step title="Check your CLAUDE.md">
    Open your project's `CLAUDE.md` to see the new directives:

    ```bash theme={null}
    cat CLAUDE.md
    ```

    Directives appear in the managed section with evidence counts:

    ```markdown theme={null}
    - **[warning]** Always use the dedicated Read tool instead of 'cat'
      via Bash. Reserve Bash for operations that have no dedicated tool
      equivalent. [sop:sop-70ad]
      _(evidence: 3 sessions)_
    ```

    <Tip>
      Each directive includes an ID (`sop:sop-xxxx`) and evidence count so you can trace why it was created.
    </Tip>
  </Step>
</Steps>

## Optional: Connect to cloud

Connect your project for cloud sync and the web dashboard:

```bash theme={null}
auto-sop install --license YOUR_LICENSE_KEY
```

All plans include cloud sync for stats and project tracking. The **Free plan** syncs 1 project; **Pro** syncs unlimited projects and adds directive sync. All cloud communication is encrypted client-side — the server never sees raw captures.

<Tip>
  Every new account gets a **14-day Pro trial** — no credit card required. During the trial you get unlimited projects, cloud directive sync, dashboard analytics, and all Pro features. After the trial ends you stay on the Free plan automatically.
</Tip>

## What's next

<CardGroup cols={2}>
  <Card title="How It Works" icon="gears" href="/docs/docs/how-it-works">
    Deep dive into the capture → detect → write → prevent pipeline.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/docs/docs/cli/overview">
    Explore all 18 CLI commands.
  </Card>
</CardGroup>