Skip to main content

​
Setup & Teardown

​
install

Install auto-sop into the current project. Sets up Claude Code hooks, the event-driven learner with a daily sweep, and the managed section in CLAUDE.md.

​
Options

​
Examples

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 the daily background sweep
  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.

​
Options

​
Examples

--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.

​
Options

​
Examples

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