save-vigil — Claude Code command: what it does, how to install
save-vigil creates a named snapshot of selected or recently modified files before risky changes. It helps preserve code state for quick recovery later.
MIT ★ 78 updated 2026-03-05
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-vigil@claude-emporiumWhat save-vigil does
The command snapshots project files by calling vigil_save(name: "<name>", files: [<paths>]). When you omit specific paths, it defaults to recently modified files.
Storage is constrained to 3 named slots alongside one rotating ~quicksave managed by hooks. Having only three named slots means you must clean up checkpoints manually once the quota fills up. Named saves remain intact until explicitly deleted.
What it helps with
- snapshot files before starting an auth rewrite
- capture database schema files prior to running migrations
- create a named recovery point for recently touched code
Example prompts for the agent
- /save-vigil auth-refactor
- /save-vigil pre-migration src/db/**
- Create a quick checkpoint before cleanup:
/save-vigil pre-cleanup src/api/**
How to install save-vigil
1Plugin marketplace
/plugin marketplace add Vvkmnn/claude-emporium/plugin install claude-vigil@claude-emporium2Manually: put the files in place
.claude/commands/save-vigil.mdCall it with /save-vigil. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/save-vigil.mdCall it with /prompts:save-vigil. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/save-vigil.prompt.mdManually: put the files in place
.gemini/commands/save-vigil.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about save-vigil
How to install save-vigil in Claude Code?
Add the marketplace using /plugin marketplace add Vvkmnn/claude-emporium, then run /plugin install claude-vigil@claude-emporium.
What does the save-vigil command do?
It invokes vigil_save to create a checkpoint with a given name, capturing specified paths or recently modified files.
How many checkpoints can you keep at once?
It provides 3 named slots that persist until deleted, plus one rotating ~quicksave slot handled by hooks.
Source text
save-vigil.md · MIT
--- name: save-vigil description: Create a named file checkpoint arguments: name, files? --- # /save-vigil Create a named checkpoint of files for later recovery. ## Usage - `/save-vigil auth-refactor` - Save with a name - `/save-vigil pre-migration src/db/**` - Save specific files ## Action Call `vigil_save(name: "<name>", files: [<paths>])` with: - `name`: Descriptive checkpoint name - `files`: Array of file paths to snapshot (defaults to recently modified files) ## Slots 3 named slots + 1 rotating `~quicksave` (auto-managed by hooks). Named saves persist until explicitly deleted. ## Example ``` vigil_save( name: "before-auth-rewrite", files: ["src/auth/handler.ts", "src/middleware/session.ts"] ) ```
© vvkmnn · MIT · Vvkmnn/claude-emporium