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.

​
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. A scheduler (launchd on macOS, systemd on Linux) runs the learner hourly 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

auto-sop [options] [command]

​
Global Options

OptionDescription
-V, --versionOutput the version number
--jsonEmit stable JSON output (for scripting)
-h, --helpDisplay help for any command

​
Project Targeting

Most commands accept --project <path> to operate on a specific project directory instead of the current working directory: 
# Status of the current project
auto-sop status

# Status of a different project
auto-sop status --project ~/projects/my-app

​
All Commands

CommandDescription
installInstall hooks, scheduler, and managed CLAUDE.md section
uninstallRemove hooks, scheduler, and managed section
migrateMigrate from old claude-sop package name
learn-nowRun the learner immediately
recapShow learner recap log entries
candidatesManage LLM pattern candidates
statusShow project install status
doctorRun install health checks
recentShow recent Claude activity
showShow full turn or session details
statsShow directive-fire metrics
errorsShow recent errors from errors.jsonl
revertRestore CLAUDE.md from backup
repairFix managed-section drift
purgeWipe captures without removing hooks
pauseTemporarily disable capture + learner
resumeRe-enable capture + learner
statuslinePrint sop status for terminal prompt

​
JSON Output

Pass --json to any command for machine-readable output: 
auto-sop status --json

{
  "installed": true,
  "hooks": "ok",
  "scheduler": "ok",
  "managedSection": "ok",
  "paused": false
}
Combine --json with tools like jq to script auto-sop into CI pipelines or custom dashboards.