claude-vigil

Vigil Plugin

File recovery. Saves checkpoints before dangerous operations, diffs changes, restores files safely.

Hooks

Token cost: 0 on safe commands, ~30-50 on destructive. The regex matches: rm, rmdir, mv, sed -i, perl -i, git checkout/reset/clean/restore, output redirects.

Commands

Workflows

Checkpoint (standalone)

1. vigil_save(name: "before-refactor", files: ["src/auth.ts", "src/middleware.ts"])
2. Make changes safely
3. If something breaks: vigil_restore(name: "before-refactor")

Checkpoint (with siblings)

1. vigil_save(name: "before-refactor", files: [...])
2. If praetorian active: also praetorian_compact(type: "decisions", ...) to save the reasoning
3. Make changes — both files and context are now protected
4. If something breaks:
   • vigil_restore(name: "before-refactor") — restore files
   • praetorian_restore("before-refactor") — restore context

Recovery (standalone)

1. vigil_list() — see available checkpoints
2. vigil_diff(name: "checkpoint") — preview what would change
3. vigil_restore(name: "checkpoint") — restore files
4. Optionally: vigil_delete(name: "checkpoint") — clean up

Recovery (with siblings)

1. vigil_list() — see available checkpoints
2. vigil_diff(name: "checkpoint") — preview changes
3. If historian active: find_file_context("filename") to understand what changed and why
4. vigil_restore(name: "checkpoint") — restore files
5. If praetorian active: restore matching compaction for context

Sibling Synergy

MCP Tools Reference

Storage

Content-addressable at .claude/vigil/. 3 named slots + 1 rotating ~quicksave.

Requires

claude mcp add vigil -- npx claude-vigil-mcp