CLI Overview
How auto-sop Works
auto-sop is a Claude Code plugin powered by hooks. It installs PreToolUse, PostToolUse, and Stop hooks that silently capture every Claude Code interaction. The learner runs automatically during your session (every 10 turns) and once daily via a background sweep to detect patterns and write directives to your CLAUDE.md.
All commands are project-scoped — they operate on the current working directory by default. Use --project <path> to target a different project.
Usage
Global Options
Project Targeting
Most commands accept --project <path> to operate on a specific project directory instead of the current working directory:
All Commands
Self-Update
auto-sop keeps itself current automatically. The learner checks the npm registry for a newer version during each run and, if one is found, downloads and installs it in the background. No manual npm install is needed after your initial setup.
Run auto-sop status to see your current version and whether an update is pending.
JSON Output
Pass --json to any command for machine-readable output:
Combine --json with tools like jq to script auto-sop into CI pipelines or custom dashboards.
