Skip to main content
skill CX Codex

claude-vigil — Claude Code skill: what it does, how to install

claude-vigil saves file checkpoints and automatically quicksaves code before risky bash operations like rm or git reset. Roll back edits whenever an agent command goes wrong.

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 claude-vigil does

The skill monitors terminal executions using the PreToolUse(Bash) hook. When an agent runs dangerous commands such as rm, mv, sed -i, redirects, or git reset, it saves the affected files before execution. Safe commands cost 0 tokens, while destructive command regex matches consume around 30-50 tokens.

Manual checkpointing runs via /save-vigil and /restore-vigil. Backups live under .claude/vigil/ with SHA-256 deduplication and gzip compression. You can inspect edits with vigil_diff before restoring a saved snapshot.

Local storage is restricted to 3 named slots plus 1 rotating ~quicksave slot. Operation also requires the companion MCP server added via claude mcp add vigil -- npx claude-vigil-mcp.

What it helps with

  • restore files deleted by accidental rm or mv executions
  • snapshot target files before starting complex refactoring
  • inspect diffs between current workspace files and saved snapshots
  • safeguard against file loss during git reset or git clean

Example prompts for the agent

  • /save-vigil before-refactor src/auth.ts src/middleware.ts
  • /restore-vigil before-refactor
  • check saved checkpoints with vigil_list and show changes with vigil_diff

How to install claude-vigil

1Plugin marketplace

/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-vigil@claude-emporium

This installs the whole claude-vigil plugin with all its skills

2Skills CLI (Vercel)

npx skills add Vvkmnn/claude-emporium --skill claude-vigil -a claude-code

3Manually: put the files in place

~/.claude/skills/claude-vigil/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/claude-vigil/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about claude-vigil

How to install claude-vigil in Claude Code?

Run /plugin marketplace add Vvkmnn/claude-emporium followed by /plugin install claude-vigil@claude-emporium. Then register the MCP tool using claude mcp add vigil -- npx claude-vigil-mcp.

What does claude-vigil do?

It manages file checkpoints, diffs file edits, and restores code. It also triggers an automatic quicksave before destructive terminal commands execute.

How many checkpoints does claude-vigil keep?

Storage in .claude/vigil/ maintains 3 named slots and 1 rotating ~quicksave slot.

Source text

SKILL.md · MIT
---
name: claude-vigil
description: File checkpoint and recovery — auto-quicksaves before destructive commands, manual checkpoints for safe rollback
triggers: [PreToolUse]
---

# Vigil Plugin

File recovery. Saves checkpoints before dangerous operations, diffs changes, restores files safely.

## Hooks

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

## Commands

| Command | Description |
|---------|-------------|
| `/save-vigil <name> [files]` | Create a named file checkpoint |
| `/restore-vigil [name]` | Restore files from a checkpoint |

## Workflows

### Checkpoint (standalone)

1. `vigil_save(name: "before-refactor", files: ["src/auth.ts", "src/middleware.ts"])`
2. Make changes safely
3. If something breaks: `vigil_restore(name: "before-refactor")`

### Checkpoint (with siblings)

1. `vigil_save(name: "before-refactor", files: [...])`
2. If **praetorian** active: also `praetorian_compact(type: "decisions", ...)` to save the reasoning
3. Make changes — both files and context are now protected
4. If something breaks:
   - `vigil_restore(name: "before-refactor")` — restore files
   - `praetorian_restore("before-refactor")` — restore context

### Recovery (standalone)

1. `vigil_list()` — see available checkpoints
2. `vigil_diff(name: "checkpoint")` — preview what would change
3. `vigil_restore(name: "checkpoint")` — restore files
4. Optionally: `vigil_delete(name: "checkpoint")` — clean up

### Recovery (with siblings)

1. `vigil_list()` — see available checkpoints
2. `vigil_diff(name: "checkpoint")` — preview changes
3. If **historian** active: `find_file_context("filename")` to understand what changed and why
4. `vigil_restore(name: "checkpoint")` — restore files
5. If **praetorian** active: restore matching compaction for context

## Sibling Synergy

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

## MCP Tools Reference

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

## Storage

Content-addressable at `.claude/vigil/`. 3 named slots + 1 rotating `~quicksave`.

## Requires

```
claude mcp add vigil -- npx claude-vigil-mcp
```

© vvkmnn · MIT · Vvkmnn/claude-emporium

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set20

The whole set →
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 claude-praetorian claude-praetorian — a skill that snapshots your context before it gets compacted and brings it back later: before planning, after web research, when a subagent finishes. CX Codex +1 ★ 78repo stars claude-orator claude-orator scores prompts across seven dimensions and returns a reworked version. Use it to shape subagent requests or review prompts across a session. CX Codex +1 ★ 78repo stars claude-historian claude-historian — a skill that automatically searches past sessions before triggering web research, planning, or debugging. Reuse past solutions across projects and avoid redundant work. CX Codex +1 ★ 78repo stars claude-gladiator claude-gladiator tracks tool failures, collects observations, and prompts reflection to update rules and skills at session end. It helps the agent learn from its own mistakes. CX Codex +1 ★ 78repo stars claude-orator claude-orator is a Claude Code plugin that scores and restructures prompts before they go to subagents. Its hook suggests a rewrite for underspecified Task prompts. ★ 78repo stars

Project sponsors

Companies that keep this analytics open