Skip to main content
command CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-vigil@claude-emporium
Open on GitHub

What 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-refactor checkpoint 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-emporium

2Manually: put the files in place

.claude/commands/restore-vigil.md

Call it with /restore-vigil. For all projects use ~/.claude/commands/

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

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set20

The whole set →
search-historian search-historian — a slash command that searches your earlier Claude sessions and returns five hits, so you can reuse a fix or a decision instead of starting over. CX Codex +1 ★ 78repo stars save-vigil save-vigil creates a named snapshot of selected or recently modified files before risky changes. It helps preserve code state for quick recovery later. CX Codex +1 ★ 78repo stars reprompt-orator reprompt-orator rewrites a prompt with Anthropic techniques: scores it on seven dimensions, picks the fitting ones and hands back a restructured version. CX Codex +1 ★ 78repo stars search-oracle search-oracle searches across 17 sources for skills, plugins, and MCP servers. Useful when you need to discover and install new tooling directly inside Claude Code. CX Codex +1 ★ 78repo stars restore-praetorian restore-praetorian is a Claude Code command that retrieves past work from praetorian memory. It helps resume tasks by finding recent summaries or searching saved session context. CX Codex +1 ★ 78repo stars compact-praetorian compact-praetorian — a Claude Code command that writes the current session context into praetorian memory so it persists across sessions. Trigger it after research, exploration, or any decision worth keeping. CX Codex +1 ★ 78repo stars review-gladiator review-gladiator processes recorded observations across sessions, clusters recurring patterns, and suggests actionable workflow rules. CX Codex +1 ★ 78repo stars claude-oracle claude-oracle searches 17 sources for relevant skills, plugins, and MCP servers. It runs before planning and after Bash errors. CX Codex +1 ★ 78repo stars

Project sponsors

Companies that keep this analytics open