What It Does

auto-sop captures every Claude Code interaction, detects recurring mistakes (3+ evidence threshold), and writes enforced directives to your project's CLAUDE.md — automatically. Zero manual upkeep. Claude Code reads these directives on every session, so the same mistake never happens again.

Beyond directives, auto-sop tracks metrics — confirmed directive fires, estimated token savings — and syncs aggregate stats to the cloud dashboard so you can see your gains over time. The CLI also self-updates by checking the npm registry during learner runs, so you always run the latest version without manual upgrades.

Install

npx auto-sop install

One command. Hooks, scheduler, and managed CLAUDE.md section are configured automatically.

Or via Homebrew:

brew install auto-sop/tap/auto-sop

Quick Start

npx auto-sop install          # set up hooks + event-driven learner
# ... use Claude Code normally — captures happen silently ...
auto-sop learn-now            # trigger learning now (or wait for the automatic learner)
cat CLAUDE.md                 # directives appear in the managed section

How It Works

  Claude Code hooks (PreToolUse / PostToolUse / Stop)
          |
          v
  +---------------+
  |   Hook Shim   |  <50ms overhead, double-fork
  |  (capture)    |
  +-------+-------+
          |  stdin JSON -> scrub secrets -> write atomically
          v
  +---------------+
  | Capture Store |  per-project, timestamped, lockfile-protected
  +-------+-------+
          |
          v
  +---------------+
  |    Learner    |  event-driven + daily sweep, or on-demand
  |               |  rule-based detectors (N>=3 evidence)
  |               |  + LLM analysis (claude -p, $0 via Max)
  +-------+-------+
          |  validated directives        |  aggregate stats
          v                              v
  +---------------+              +---------------+
  |  CLAUDE.md    |              |  Stats Sync   |
  |  Editor       |              |  → Cloud      |
  +---------------+              +-------+-------+
          |                              |
          v                              v
    Claude Code reads CLAUDE.md    Dashboard shows
    -> same mistake never again    gains over time

Pricing

Free (forever)

• 1 project, unlimited directives
• Anonymous usage stats (no capture content — see Privacy)
• All CLI commands: install, uninstall, status, learn-now, stats, doctor, and more
• Uses your Claude Max subscription ($0 cost)

Pro ($12/mo or $99/yr)

• Unlimited projects
• Full cloud sync
• Web dashboard
• Cross-machine directives
• Priority support
• No credit card on trial

Earn Free Pro Trial Days

Not ready to pay? Earn Pro trial days for free:

• Referral — share your link, both you and your friend get +14 days
• GitHub Star — star the repo for +7 days (one-time)
• Tweet / LinkedIn — share about auto-sop for +3 days each (monthly)
• CLAUDE.md Badge — add the auto-sop badge for +7 trial days

See the full Rewards documentation for details.

Self-Update

auto-sop keeps itself current automatically. The learner checks the npm registry for new versions during each run and installs updates in the background — no manual npm install needed after your initial setup. Run auto-sop status to see your current version at any time.

Compatibility

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

Privacy

Captures never leave your machine — all analysis runs locally via your own Claude Max subscription. Anonymous aggregate stats (error rates, CLI command counts) are synced; no capture content is included. Pro cloud sync is opt-in and encrypted client-side (AES-256) before upload.

For full details, see our Privacy Documentation.

Documentation

Full documentation is available at auto-sop.com/docs.

Star History

Contributors

License

Elastic License 2.0 (ELv2)