# Claude Vigil Mcp > ๐Ÿบ An MCP server for checkpointing and file recovery in Claude Code - **Type:** MCP server - **Install:** `agentstack add mcp-vvkmnn-claude-vigil-mcp` - **Verified:** Yes โ€” security-reviewed for prompt injection and unsafe behavior - **Seller:** [Vvkmnn](https://agentstack.voostack.com/s/vvkmnn) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [Vvkmnn](https://github.com/Vvkmnn) - **Source:** https://github.com/Vvkmnn/claude-vigil-mcp ## Install ```sh agentstack add mcp-vvkmnn-claude-vigil-mcp ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # claude-vigil-mcp An [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for **checkpoint, snapshot, and file recovery** in [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Perfect snapshots, selective restore, bash safety net, and honest disk management. [](https://www.npmjs.com/package/claude-vigil-mcp) [](https://opensource.org/licenses/MIT) [](https://www.typescriptlang.org/) [](https://nodejs.org/) [](#) [](https://github.com/Vvkmnn/claude-vigil-mcp) --- Every AI coding tool tracks file edits made through its own editor, but none of them track file changes made externally: bash commands (`rm`, `mv`, `sed -i`), Python scripts, build tools, or any process that modifies files outside the editor's API. When those changes go wrong, there's nothing to rewind to. Claude Code's built-in `/rewind` has additional gaps -- external changes are invisible ([#6413](https://github.com/anthropics/claude-code/issues/6413), [#10077](https://github.com/anthropics/claude-code/issues/10077)), rewind is all-or-nothing with no selective file restore, timestamps only with no named checkpoints, and reliability bugs ([#21608](https://github.com/anthropics/claude-code/issues/21608), [#18516](https://github.com/anthropics/claude-code/issues/18516)). ## install **Requirements:** [](https://claude.ai/code) **From shell:** ```bash claude mcp add claude-vigil-mcp -- npx claude-vigil-mcp ``` **From inside Claude** (restart required): ``` Add this to our global mcp config: npx claude-vigil-mcp Install this mcp: https://github.com/Vvkmnn/claude-vigil-mcp ``` **From any manually configurable `mcp.json`**: (Cursor, Windsurf, etc.) ```json { "mcpServers": { "claude-vigil-mcp": { "command": "npx", "args": ["claude-vigil-mcp"], "env": {} } } } ``` There is **no `npm install` required** -- no external databases, no indexing, only Node.js built-ins for crypto, compression, and filesystem. However, if `npx` resolves the wrong package, you can force resolution with: ```bash npm install -g claude-vigil-mcp ``` ## [skill](.claude/skills/claude-vigil) Optionally, install the skill to teach Claude when to proactively checkpoint before risky work: ```bash npx skills add Vvkmnn/claude-vigil-mcp --skill claude-vigil --global # Optional: add --yes to skip interactive prompt and install to all agents ``` This makes Claude automatically save checkpoints before destructive bash commands, risky refactors, or context compaction. The MCP works without the skill, but the skill improves discoverability. ## [plugin](https://github.com/Vvkmnn/claude-emporium) For automatic checkpointing with hooks and commands, install from the [claude-emporium](https://github.com/Vvkmnn/claude-emporium) marketplace: ```bash /plugin marketplace add Vvkmnn/claude-emporium /plugin install claude-vigil@claude-emporium ``` The **claude-vigil** plugin provides: **Hooks** (background, zero-latency): - `PreToolUse (Bash)` - auto-quicksave before destructive commands (`rm`, `mv`, `sed -i`, `git checkout`, `git reset`) - `PreCompact` - auto-checkpoint before context compaction, both manual (`/compact`) and automatic - `Stop` - auto-checkpoint after Claude finishes a response that included file edits - `PostToolUse (Write|Edit)` - checkpoint after file modifications - `SessionEnd` - last-chance checkpoint when the session terminates **Command:** `/checkpoint ` Requires the MCP server installed first. See the emporium for other Claude Code plugins and MCPs. ## features 5 tools. Perfect snapshots. Content diffs. Safe restores with artifact preservation. #### vigil_save Create a named checkpoint of the entire project. Optional `description` for annotation. If slots are full, Claude asks the user whether to delete an existing checkpoint or increase capacity. ``` ๐Ÿบ โ”โ” saved "before-refactor" โ”โ” 47 files ยท 4.2 MB โ”โ” vigil: 2/3 | quicksave: 8m ago | 4.2 MB โ”— skipped: node_modules, dist, .next ``` First save auto-detects derived directories from `.gitignore` and creates `.vigilignore`: ``` ๐Ÿบ โ”โ” saved "v1.0" โ”โ” 47 files ยท 4.1 MB โ”โ” vigil: 1/3 | quicksave: none | 4.1 MB โ”ƒ skipped: node_modules, dist, .next โ”ƒ first save -- confirm these exclusions look correct โ”— edit .claude/vigil/.vigilignore to adjust ``` When slots are full: ``` ๐Ÿบ โ”โ” 3/3 full -- ask the user before proceeding โ”โ” vigil: 3/3 | quicksave: 2m ago | 8.7 MB โ”ƒ v1.0 (2h ago) ยท before-refactor (45m ago) ยท experiment (5m ago) โ”— ASK the user: delete one with vigil_delete, or increase capacity with max_checkpoints? ``` #### vigil_list Browse checkpoints with descriptions. With `name`: drill into that checkpoint's files. With `glob`: filter files by pattern. ``` ๐Ÿบ โ”โ” 2 checkpoints โ”โ” vigil: 2/3 | quicksave: 3m ago | 8.7 MB โ”ƒ v1.0 2h ago 47 files โ”ƒ Initial stable release โ”ƒ before-refactor 45m ago 47 files โ”ƒ Snapshot before risky auth changes โ”— ~quicksave 3m ago ``` Drill into a checkpoint with glob filtering: ``` vigil_list name="v1.0" glob="src/auth/**" ``` ``` ๐Ÿบ โ”โ” v1.0 โ”โ” 3 of 47 files matching src/auth/** โ”โ” vigil: 2/3 | quicksave: 3m ago | 8.7 MB โ”ƒ src/auth/index.ts โ”ƒ src/auth/middleware.ts โ”— src/auth/types.ts ``` #### vigil_diff Search and investigate previous versions of your codebase. Compare a checkpoint against the current working directory with full unified diffs, compare two checkpoints against each other, retrieve any file's content from any checkpoint, or search for a string across all checkpoints. **Summary of changes:** ``` vigil_diff name="before-refactor" summary=true ``` ``` ๐Ÿบ โ”โ” 3 changes vs before-refactor โ”โ” vigil: 2/3 | quicksave: 3m ago | 8.7 MB โ”ƒ modified src/auth.ts (+8 -2) โ”ƒ modified src/middleware/validate.ts (+3 -1) โ”— added src/services/oauth.ts ``` **Full unified diffs:** ``` vigil_diff name="before-refactor" ``` ``` ๐Ÿบ โ”โ” 3 changes vs before-refactor โ”โ” vigil: 2/3 | quicksave: 3m ago | 8.7 MB โ”ƒ modified src/auth.ts (+8 -2) โ”ƒ modified src/middleware/validate.ts (+3 -1) โ”— added src/services/oauth.ts โ”โ” src/auth.ts โ”โ” --- a/src/auth.ts +++ b/src/auth.ts @@ -12,6 +12,8 @@ import { validateToken } from './utils'; -function authenticate(req: Request) { +function authenticate(req: Request, options?: AuthOptions) { + if (options?.skipValidation) return true; const token = req.headers.authorization; ``` **Retrieve a single file from a checkpoint:** ``` vigil_diff name="v1.0" file="src/auth.ts" ``` ``` ๐Ÿบ โ”โ” src/auth.ts from v1.0 โ”โ” import { validateToken } from './utils'; function authenticate(req: Request) { const token = req.headers.authorization; ... โ”โ” diff vs current โ”โ” --- a/src/auth.ts +++ b/src/auth.ts @@ -12,6 +12,8 @@ -function authenticate(req: Request) { +function authenticate(req: Request, options?: AuthOptions) { ``` **Compare two checkpoints:** ``` vigil_diff name="v1.0" against="before-refactor" ``` Shows unified diffs between the two checkpoint states -- no working directory involved. **Search across all checkpoints:** ``` vigil_diff name="*" file="src/auth.ts" search="validateToken" ``` ``` ๐Ÿบ โ”โ” "validateToken" in src/auth.ts โ”โ” 2 checkpoints โ”โ” vigil: 2/3 | quicksave: 3m ago | 8.7 MB โ”ƒ v1.0 (2h ago) โ”ƒ import { validateToken } from './utils'; โ”ƒ before-refactor (45m ago) โ”— import { validateToken } from './utils'; ``` #### vigil_restore Restore the project to a checkpoint state. Quicksaves current state first (undo with `vigil_restore name="~quicksave"`). Displaced files -- both modified and newly created since the checkpoint -- are preserved in `.claude/vigil/artifacts/` so nothing is ever lost. For individual file restores, use `vigil_diff` to retrieve file content, then apply with Edit. ``` vigil_restore name="v1.0" ``` ``` ๐Ÿบ โ”โ” restored from "v1.0" โ”โ” 47 files โ”โ” vigil: 2/3 | quicksave: just now | 8.7 MB โ”ƒ preserved 3 displaced files in .claude/vigil/artifacts/restored_v1.0_20260219_143022/ โ”ƒ modified: src/auth.ts (current version saved) โ”ƒ modified: src/middleware/validate.ts (current version saved) โ”ƒ new: src/services/oauth.ts (moved, not in checkpoint) โ”ƒ review .claude/vigil/artifacts/restored_v1.0_20260219_143022/ -- delete when no longer needed โ”ƒ previous state also quicksaved (use ~quicksave to undo) โ”ƒ not restored (derived): node_modules, dist โ”— rebuild these before running the project ``` #### vigil_delete Delete a checkpoint and reclaim disk space. GC removes unreferenced objects. Use `all=true` to delete everything. ``` vigil_delete name="v1.0" ``` ``` ๐Ÿบ โ”โ” deleted v1.0 โ”โ” reclaimed 241 MB (3,412 objects) โ”โ” vigil: 1/3 | quicksave: 3m ago | 4.5 MB ``` ## methodology How [claude-vigil-mcp](https://github.com/Vvkmnn/claude-vigil-mcp) [stores](https://github.com/Vvkmnn/claude-vigil-mcp/tree/main/src) checkpoints: ``` ๐Ÿบ claude-vigil-mcp โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” Claude calls tool vigil_save โ”‚ โ–ผ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ spawn worker โ”‚ _**[Claudius Proclaimed Emperor](https://en.wikipedia.org/wiki/Claudius#/media/File:Lebayle_-_Claudius.jpg)** by **[Charles Lebayle](https://en.wikipedia.org/wiki/Charles_Lebayle)** (1886). Claudius expanded the Vigiles Urbani from firefighters into Rome's night watch -- guardians who patrolled the city, preserved order, and ensured nothing was lost to the dark._ ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source โ€” we do not rehost the code. - **Author:** [Vvkmnn](https://github.com/Vvkmnn) - **Source:** [Vvkmnn/claude-vigil-mcp](https://github.com/Vvkmnn/claude-vigil-mcp) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** โ€” Free ## Security capabilities Automated source analysis of v0.1.0 โ€” what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** yes - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source โ€” more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** โ€” security scan: passed โ€” Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-vvkmnn-claude-vigil-mcp - Seller: https://agentstack.voostack.com/s/vvkmnn - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack โ€” the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.