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.

revert

Restore CLAUDE.md from the most recent learner backup. Use this if the learner produced a bad directive or if you accidentally modified the managed section.
auto-sop revert [options]

Options

OptionDescription
--project <path>Project root (default: current directory)
--dry-runDescribe what would happen without modifying files

Examples

auto-sop revert --dry-run

How Revert Works

The learner creates a backup of CLAUDE.md before every write. revert restores the most recent backup, effectively undoing the last learner run.
Revert only affects the managed section of CLAUDE.md. Any content you’ve written outside the managed section (above or below the markers) is preserved.

repair

Fix managed-section drift deadlock and clean stale state. Use this when status or doctor reports a hash mismatch or deadlock condition.
auto-sop repair [options]

Options

OptionDescription
--project <path>Project root (default: current directory)

Example

auto-sop repair

When to Use Repair

  • doctor reports “managed section hash mismatch”
  • The learner refuses to write due to drift detection
  • You manually edited content inside the managed section markers
  • After resolving a git merge conflict in CLAUDE.md
repair recalculates the integrity hash of the managed section, allowing the learner to write again. It does not modify your directives — only fixes the metadata.

purge

Wipe all captured interaction data (project + global) without removing hooks or the scheduler. The next learner run starts from scratch with no history.
auto-sop purge [options]

Options

OptionDescription
--project <path>Project root (default: current directory)
--yesSkip confirmation prompt

Examples

auto-sop purge
Purge permanently deletes all captured interaction data. Existing directives in CLAUDE.md are not removed — only the raw captures that feed the learner. This cannot be undone.

Purge vs. Uninstall

ActionHooksSchedulerDirectivesCaptures
purgeKeptKeptKeptDeleted
uninstallRemovedRemovedRemovedKept
uninstall --purgeRemovedRemovedRemovedDeleted