Skip to main content

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

From install to your first directive in 5 minutes.

System requirements

RequirementVersion
Node.js>= 18.17
OSmacOS, Linux, or Windows
Claude Code>= 2.1.107
1

Install the CLI

Run the installer from your project directory:
npx auto-sop install
Or install via Homebrew (macOS/Linux):
brew install auto-sop/tap/auto-sop
auto-sop install
The installer configures hooks, the hourly scheduler, and the managed section in CLAUDE.md.
✔ Hook shim installed (.auto-sop/hooks/)
✔ Scheduler registered (launchd/systemd)
✔ Managed section added to CLAUDE.md
✔ Ready — captures will begin on next Claude Code session
2

Use Claude Code normally

Just keep working as usual. auto-sop captures tool calls silently in the background with less than 50ms overhead.
claude  # start a session — captures happen automatically
Captures are stored locally in .auto-sop/captures/ — they never leave your machine on the free tier.
3

Trigger learning

The learner runs hourly by default. To trigger it immediately:
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
4

Check your CLAUDE.md

Open your project’s CLAUDE.md to see the new directives:
cat CLAUDE.md
Directives appear in the managed section with evidence counts:
- **[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)_
Each directive includes an ID (sop:sop-xxxx) and evidence count so you can trace why it was created.

Optional: Connect to cloud

Connect your project for cloud sync and the web dashboard:
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.
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.

What’s next

How It Works

Deep dive into the capture → detect → write → prevent pipeline.

CLI Reference

Explore all 18 CLI commands.