Help us improve
Share bugs, ideas, or general feedback.
From claude-vigil
Auto-quicksaves files before destructive bash commands (rm, mv, git reset); manual checkpoints, diffs, lists, and restores for safe file recovery.
npx claudepluginhub vvkmnn/claude-emporium --plugin claude-vigilHow this skill is triggered — by the user, by Claude, or both
Slash command
/claude-vigil:claude-vigilThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
File recovery. Saves checkpoints before dangerous operations, diffs changes, restores files safely.
Automatically tracks Claude's file edits and conversations. Rewind code changes, chat history, or both via /rewind or Esc+Esc. Summarizes sessions to manage context and recover from errors.
Manages Git checkpoints via tags: create before risky refactors or multi-step work, restore for rollbacks, list, and clean. Uses Bash for safe Git operations.
Saves and restores task state for mid-task rollback points before risky operations like refactors, migrations, or destructive edits.
Share bugs, ideas, or general feedback.
File recovery. Saves checkpoints before dangerous operations, diffs changes, restores files safely.
| Hook | When | Action |
|---|---|---|
| PreToolUse(Bash) | Destructive command detected | Auto-quicksaves affected files (rm, mv, git reset, etc.) |
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.
| Command | Description |
|---|---|
/save-vigil <name> [files] | Create a named file checkpoint |
/restore-vigil [name] | Restore files from a checkpoint |
vigil_save(name: "before-refactor", files: ["src/auth.ts", "src/middleware.ts"])vigil_restore(name: "before-refactor")vigil_save(name: "before-refactor", files: [...])praetorian_compact(type: "decisions", ...) to save the reasoningvigil_restore(name: "before-refactor") — restore filespraetorian_restore("before-refactor") — restore contextvigil_list() — see available checkpointsvigil_diff(name: "checkpoint") — preview what would changevigil_restore(name: "checkpoint") — restore filesvigil_delete(name: "checkpoint") — clean upvigil_list() — see available checkpointsvigil_diff(name: "checkpoint") — preview changesfind_file_context("filename") to understand what changed and whyvigil_restore(name: "checkpoint") — restore files| Sibling | Value | How |
|---|---|---|
| Praetorian | Context saved alongside files | Pair vigil checkpoints with praetorian compactions for full state recovery |
| Historian | File change context from history | find_file_context() explains what happened between checkpoint and now |
| Tool | Purpose |
|---|---|
vigil_save | Create named checkpoint (SHA-256 + gzip dedup) |
vigil_list | List available checkpoints with metadata |
vigil_diff | Preview changes since checkpoint |
vigil_restore | Restore files from checkpoint |
vigil_delete | Remove a checkpoint and free storage |
Content-addressable at .claude/vigil/. 3 named slots + 1 rotating ~quicksave.
claude mcp add vigil -- npx claude-vigil-mcp