claude-vigil — скилл для Claude Code: что делает и как установить
Скилл claude-vigil создаёт чекпоинты файлов и автоматически сохраняет их перед опасными bash-командами вроде rm или git reset. Защищает проект от случайной потери кода.
MIT ★ 78 обновлён 2026-03-05
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-vigil@claude-emporiumЧто делает claude-vigil
Скилл отслеживает вызовы терминала через хук PreToolUse(Bash). Если агент собирается выполнить rm, mv, sed -i или сбросить рабочую копию через git reset, плагин делает снимок затрагиваемых файлов до запуска команды. Безопасные операции не тратят токены, а на опасных командах уходит порядка 30–50 токенов.
Для ручного управления версиями доступны команды /save-vigil и /restore-vigil. Файлы упаковываются через gzip с дедупликацией по SHA-256 в каталог .claude/vigil/. Доступны просмотр изменений через vigil_diff и восстановление файлов из сохранённого состояния.
Локальное хранилище вмещает всего 3 именованных слота и один ротируемый слот ~quicksave. Для работы плагину требуется запущенный MCP-сервер, который подключается вызовом claude mcp add vigil -- npx claude-vigil-mcp.
Какие задачи решает
- откатить файлы после случайного запуска
rmилиmv - сохранить именованный снимок файлов перед сложным рефакторингом
- просмотреть diff между рабочей копией и точкой восстановления
- защитить код от очистки при вызовах
git resetилиgit clean
Примеры запросов агенту
- /save-vigil before-refactor src/auth.ts src/middleware.ts
- /restore-vigil before-refactor
- покажи список доступных снимков через vigil_list и сравни изменения
Как установить claude-vigil
1Через маркетплейс плагинов
/plugin marketplace add Vvkmnn/claude-emporium/plugin install claude-vigil@claude-emporiumКоманда ставит плагин claude-vigil целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add Vvkmnn/claude-emporium --skill claude-vigil -a claude-code3Вручную: положить файлы
~/.claude/skills/claude-vigil/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/claude-vigil/
1Через Skills CLI (Vercel)
npx skills add Vvkmnn/claude-emporium --skill claude-vigil -a codex2Вручную: положить файлы
.agents/skills/claude-vigil/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Vvkmnn/claude-emporium --skill claude-vigil -a cursor2Вручную: положить файлы
.cursor/skills/claude-vigil/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Vvkmnn/claude-emporium plugins/claude-vigil/skills/claude-vigil2Вручную: положить файлы
.github/skills/claude-vigil/SKILL.md1Через Skills CLI (Vercel)
npx skills add Vvkmnn/claude-emporium --skill claude-vigil -a gemini-cli2Командой платформы
gemini skills install https://github.com/Vvkmnn/claude-emporium --path plugins/claude-vigil/skills/claude-vigilВручную: положить файлы
.devin/skills/claude-vigil/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о claude-vigil
Как установить claude-vigil в Claude Code?
Выполните в терминале агента по очереди две команды: /plugin marketplace add Vvkmnn/claude-emporium, затем /plugin install claude-vigil@claude-emporium. После этого добавьте MCP-сервер: claude mcp add vigil -- npx claude-vigil-mcp.
Что делает claude-vigil?
Скилл управляет снимками файлов, показывает разницу изменений и возвращает файлы к контрольной точке. Он автоматически сохраняет код перед потенциально деструктивными операциями в терминале.
Сколько чекпоинтов сохраняет claude-vigil?
В каталоге .claude/vigil/ предусмотрено 3 именованных слота и 1 перезаписываемый слот ~quicksave для автоматических сохранений.
Исходный текст
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