Cursor Checkpoints — это локальные снимки кодовой базы во время сессии Agent. Агент делает их сам перед значимыми изменениями и сохраняет состояние всех затронутых файлов. Канон: docs Agent → Checkpoints.
Работа в агенте — Agent Mode. Окно агентов — Agents Window. Отладка с гипотезами — Debug Mode. Pillar: n8n для начинающих.
Для кого Checkpoints
- Агент правит много файлов, и нужен быстрый откат без git reset.
- Exploratory рефакторинг: «попробуем ветку мысли», потом откат.
- Итерации, где чат оставляете, а файлы возвращаете к точке.
- Страхуете сложный multi-file diff до commit в Git.
Как пользоваться: маршрут на 10 минут
- Запустите Agent и дайте задачу с правками файлов — checkpoint создаётся автоматически перед значимыми изменениями.
- В timeline чата найдите точки checkpoint.
- Кликните checkpoint → preview состояния файлов.
- Если откат нужен — Restore Checkpoint (кнопка на прошлом запросе или «+» у сообщения).
- Проверьте: файлы откатились, история чата на месте. Дальше фиксируйте удачное состояние уже в Git.
| Действие | Что происходит | Источник |
|---|---|---|
| Auto-create | Снимок перед значимыми правками агента | docs/agent/overview |
| Preview | Смотрите файлы на точке timeline | клик по checkpoint |
| Restore | Файлы → состояние снимка; чат не чистится | Restore Checkpoint / «+» |
| Хранение | Локально, отдельно от Git | docs/agent/overview |
| Назначение | Откат правок агента, не замена Git | docs/agent/overview |
Поведение checkpoints — docs/agent/overview, раздел Checkpoints (проверка 2026-09-04).
Checkpoints vs Git
| Критерий | Checkpoints | Git |
|---|---|---|
| Кто создаёт | Agent автоматически | Вы (commit) |
| Где хранится | Локально, вне Git | Репозиторий / remote |
| Откат чата | Нет (только файлы) | Не связан с чатом |
| Постоянный VCS | Нет | Да |
Правило из доки: checkpoints — страховка от «агент ушёл не туда»; релизы и история команды — только через Git.
Сильные стороны
- Не нужно вручную stash/commit перед каждым рискованным промптом.
- Preview до restore снижает шанс откатиться «не туда».
- Чаты остаются — можно объяснить агенту, почему откат и куда дальше.
- Удобны на длинных рефакторингах с несколькими попытками.
Типичные ошибки
- Считать checkpoint заменой commit и пушить «как есть» без Git.
- Ждать, что restore сотрёт сообщения и «очистит контекст» — дока говорит обратное.
- Откатываться после ручных правок поверх агента, не проверив preview.
- Путать checkpoints агента с worktrees в Agents Window.
FAQ: Cursor Checkpoints
Что такое Cursor Checkpoints?
Checkpoints — локальные снимки кодовой базы в сессии Agent. Агент создаёт их автоматически перед значимыми правками, фиксируя состояние изменённых файлов. Канон: docs/agent/overview (раздел Checkpoints).
Как восстановить checkpoint?
Кликните checkpoint в timeline чата: сначала preview файлов, затем restore. Также кнопка Restore Checkpoint на прошлых запросах или «+» при наведении на сообщение. Restore откатывает только файлы, сообщения в чате не удаляет.
Checkpoints — это то же самое, что Git?
Нет. Checkpoints хранятся локально и отдельно от Git. Дока: используйте их только для отката правок агента; для постоянного version control — Git.
Когда checkpoints полезны?
Exploratory work, сложный рефакторинг и итеративная разработка, где нужны безопасные точки отката, если агент пошёл не туда.
Удаляет ли restore историю чата?
Нет. Restore Checkpoint возвращает файлы к состоянию снимка; сообщения в conversation остаются.
Вывод
Cursor Checkpoints — автоснимки файлов в сессии Agent для безопасного отката. Это не Git. Режим работы — Agent Mode; параллель задач — Agents Window.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Тех-pillar — n8n для начинающих.