restore — команда для Claude Code: что делает и как установить
Команда restore в Claude Code возвращает проект к сохранённой контрольной точке Git. Откатывает недавние правки, если они сломали сборку.
MIT ★ 763 обновлён 2026-03-31
.claude/commands/restore.mdЧто делает restore
Команда ищет в стеше Git записи с меткой claude-checkpoint, сохранённые через /checkpoint. В качестве аргумента принимает слово latest или порядковый номер, чтобы восстановить нужный слепок.
Если в рабочей директории остались незакоммиченные файлы, restore не затирает их. Скрипт создаёт резервный стеш с текущей датой вида claude-restore-backup, а затем накатывает выбранную точку через git stash apply.
Контрольные точки не удаляются после отката, так как команда принципиально вызывает apply, а не pop. Для выполнения нужны утилиты git, grep и head в окружении Bash.
Какие задачи решает
- Откатить рабочую директорию до последней сохранённой контрольной точки
- Применить конкретный промежуточный слепок кода по его номеру
- Автоматически сохранить незакоммиченные правки в резервный стеш перед откатом
Примеры запросов агенту
- /restore
- /restore latest
- /restore 2
Как установить restore
Вручную: положить файлы
.claude/commands/restore.mdВызов — /restore. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/restore.mdВызов — /prompts:restore. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/restore.prompt.mdВручную: положить файлы
.gemini/commands/restore.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о restore
Как установить restore в Claude Code?
Сохраните файл команды по пути .claude/commands/restore.md. После этого вызов /restore станет доступен в терминале Claude Code.
Что делает команда restore?
Она находит контрольные точки claude-checkpoint в стеше Git и накатывает файлы выбранной ревизии на текущее рабочее дерево.
Удаляется ли контрольная точка после отката?
Нет, команда запускает git stash apply, а не git stash pop. Сохранённая запись остаётся в списке стеша для повторного применения.
Исходный текст
restore.md · MIT
---
description: Restore project to a previous checkpoint
category: workflow
allowed-tools: Bash(git stash:*), Bash(git status:*), Bash(git reset:*), Bash(grep:*), Bash(head:*)
argument-hint: "<checkpoint-number|latest>"
---
## Restore to checkpoint
Restore your project files to a previous checkpoint created with /checkpoint.
## Available checkpoints
!`git stash list | grep "claude-checkpoint" | head -10`
## Current status
!`git status --short`
## Task
Restore the project to a previous checkpoint. Based on $ARGUMENTS:
1. Parse the argument:
- If empty or "latest": Find the most recent claude-checkpoint stash
- If a number (e.g. "2"): Use stash@{2} if it's a claude-checkpoint
- Otherwise: Show error and list available checkpoints
2. Check for uncommitted changes with `git status --porcelain`. If any exist:
- Create a temporary backup stash: `git stash push -m "claude-restore-backup: $(date +%Y-%m-%d_%H:%M:%S)"`
- Note the stash reference for potential recovery
3. Apply the checkpoint:
- Use `git stash apply stash@{n}` (not pop, to preserve the checkpoint)
- If there's a conflict due to uncommitted changes that were stashed, handle gracefully
4. Show what was restored:
- Display which checkpoint was applied
- If uncommitted changes were backed up, inform user how to recover them
Example outputs:
- For `/restore`: "Restored to checkpoint: before major refactor (stash@{0})"
- For `/restore 3`: "Restored to checkpoint: working OAuth implementation (stash@{3})"
- With uncommitted changes: "Backed up current changes to stash@{0}. Restored to checkpoint: before major refactor (stash@{1})"
© carlrannaberg · MIT · carlrannaberg/claudekit