restore-vigil — Claude Code command for checkpoint recovery
restore-vigil is a Claude Code command that lists saved checkpoints and restores files from a selected one. It supports returning a project to an earlier saved state.
MIT ★ 78 updated 2026-03-05
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-vigil@claude-emporiumWhat restore-vigil does
Run /restore-vigil to see the checkpoints available for recovery. To restore one, pass its name, such as auth-refactor. The command can preview the differences with vigil_diff before it calls vigil_restore for the selected checkpoint.
It starts by fetching the list with vigil_list(). That lets you choose the save point, while the preview shows what will change before recovery. Restoring requires the name of an existing checkpoint; without an argument, the command lists checkpoints instead of choosing one for you.
What it helps with
- list available checkpoints
- select a checkpoint by name
- preview changes before a rollback
- restore files from a saved checkpoint
Example prompts for the agent
- List the available checkpoints with
/restore-vigil. - Restore files from the
auth-refactorcheckpoint using/restore-vigil auth-refactor. - Show the changes for a checkpoint, then restore it with
/restore-vigil.
How to install restore-vigil
1Plugin marketplace
/plugin marketplace add Vvkmnn/claude-emporium/plugin install claude-vigil@claude-emporium2Manually: put the files in place
.claude/commands/restore-vigil.mdCall it with /restore-vigil. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/restore-vigil.mdCall it with /prompts:restore-vigil. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/restore-vigil.prompt.mdManually: put the files in place
.gemini/commands/restore-vigil.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about restore-vigil
How do I install restore-vigil in Claude Code?
Run /plugin marketplace add Vvkmnn/claude-emporium, then /plugin install claude-vigil@claude-emporium. The command file path is .claude/commands/restore-vigil.md.
What does restore-vigil do?
It lists saved checkpoints and restores files from the one you select. You can preview the differences first.
Do I need to provide a checkpoint name?
Yes, when restoring, pass the name after /restore-vigil. With no argument, the command lists the available checkpoints.
Source text
restore-vigil.md · MIT
--- name: restore-vigil description: Restore files from a checkpoint arguments: name? --- # /restore-vigil Restore files from a previously saved checkpoint. ## Usage - `/restore-vigil` - List available checkpoints - `/restore-vigil auth-refactor` - Restore specific checkpoint ## Action 1. Call `vigil_list()` to show available checkpoints 2. Optionally call `vigil_diff(name: "<name>")` to preview changes 3. Call `vigil_restore(name: "<name>")` to restore ## Example ``` > vigil_list() Checkpoints: 1. "before-auth-rewrite" (2 files, 3m ago) 2. "~quicksave" (1 file, 30s ago) > vigil_diff(name: "before-auth-rewrite") src/auth/handler.ts: 12 lines changed > vigil_restore(name: "before-auth-rewrite") Restored 2 files from "before-auth-rewrite" ```
© vvkmnn · MIT · Vvkmnn/claude-emporium