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.

​
install

Install auto-sop into the current project. Sets up Claude Code hooks, the hourly scheduler, and the managed section in CLAUDE.md. 
auto-sop install [options]

​
Options

OptionDescription
--license <key>License key (non-interactive; skips prompt)
--project <path>Project root (default: current directory)
--no-restoreSkip restoring directives from a previous install (clean slate)

​
Examples

npx auto-sop install
After install, use Claude Code normally. Captures happen silently in the background with less than 50ms overhead per hook invocation.

​
What Install Does

  1. Hooks — Registers PreToolUse, PostToolUse, and Stop hooks in .claude/settings.local.json
  2. Scheduler — Creates a launchd plist (macOS) or systemd timer (Linux) for hourly learning
  3. CLAUDE.md — Adds a managed section to your project’s CLAUDE.md (creates the file if needed)
  4. Restore — If a previous install had directives, restores them (unless --no-restore)

​
uninstall

Remove auto-sop hooks, scheduler, and the managed section from CLAUDE.md. 
auto-sop uninstall [options]

​
Options

OptionDescription
--purgeAlso wipe all captures (project + global)
--project <path>Project root (default: current directory)

​
Examples

auto-sop uninstall
--purge permanently deletes all captured interaction data. This cannot be undone.

​
migrate

Migrate from the old claude-sop package name to auto-sop. Updates directory paths, launchd plists, and hook references. 
auto-sop migrate [options]

​
Options

OptionDescription
--project <path>Project root to migrate hooks (default: current directory)
--dry-runShow what would change without acting

​
Examples

auto-sop migrate --dry-run
Only needed if you previously installed the claude-sop package (pre-rename). New users can skip this command entirely.