Skip to main content
command CX Codex

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

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 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-emporium

2Manually: put the files in place

.claude/commands/save-vigil.md

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

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

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 restore-vigil 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. 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