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.
auto-sop install [options]
Options Option Description --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 Basic Install
With License Key
Clean Slate
Target Specific Project
After install, use Claude Code normally. Captures happen silently in the background with less than 50ms overhead per hook invocation.
What Install Does
Hooks — Registers PreToolUse, PostToolUse, and Stop hooks in .claude/settings.local.jsonScheduler — Creates a launchd plist (macOS) or systemd timer (Linux) for the daily background sweepCLAUDE.md — Adds a managed section to your project’s CLAUDE.md (creates the file if needed)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 Option Description --purgeAlso wipe all captures (project + global) --project <path>Project root (default: current directory)
Examples Standard Uninstall
Full Purge
--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 Option Description --project <path>Project root to migrate hooks (default: current directory) --dry-runShow what would change without acting
Examples Preview Migration
Execute Migration
auto-sop migrate --dry-run
Only needed if you previously installed the claude-sop package (pre-rename). New users can skip this command entirely.
