Чекпоинты и откат
Каждый отправленный промпт открывает чекпоинт: снимок беседы плюс резервную копию каждого файла, который Command Code затем отредактирует. Если что-то пошло не так, откатитесь к любому более раннему чекпоинту и продолжайте оттуда.
Как открыть интерфейс отката
Нажмите Esc дважды в течение 500 мс или выполните:
/rewindКаждая строка в списке показывает, когда был сделан чекпоинт, превью сообщения, которое его открыло, и сколько файлов изменил этот чекпоинт (или No code changes).
Режимы восстановления
| Режим | Что восстанавливает |
|---|---|
| Both | Восстанавливает беседу и код вместе (рекомендуется). |
| Conversation only | Удаляет сообщения после чекпоинта. Файлы не трогаются. |
| Code only | Восстанавливает файлы в состояние на момент чекпоинта. Беседа не трогается. |
Чекпоинты, в которых не было изменений файлов, предлагают только Conversation only.
Примечание
Откат удаляет сообщения после чекпоинта и сам чекпоинт. Вы попадаете до сообщения, которое его открыло. Счётчик токенов контекста обновляется, отражая более короткую беседу.
Примечание
Откаты сохраняются. Если вы откатились и затем вышли, при возобновлении сессии вы увидите именно откаченное состояние. Это не предпросмотр.
Что откат файлов делает с рабочим деревом
Откат в режиме Code only или Both делает больше, чем отменяет правки. Он возвращает дерево в прежнее состояние:
| Если файл был… | После отката |
|---|---|
| Изменён после чекпоинта | Восстановлен в состояние на момент чекпоинта |
| Создан после чекпоинта | Удалён, поскольку на момент чекпоинта его не существовало |
| Удалён после чекпоинта | Восстановлен |
Резервные копии делаются перед каждым вызовом write_file или edit_file и воспроизводятся от новых к старым, поэтому серия правок одного файла возвращается к его самому старому состоянию. Копии побайтово точны, так что бинарные файлы (изображения, скомпилированные артефакты) переживают цикл «копия — восстановление» без изменений, без какой-либо особой обработки.
Восстановление проверяется до запуска
Command Code проверяет, что каждую копию из набора действительно можно восстановить, до того, как что-либо записать, поэтому откат либо применяется целиком, либо не применяется вообще; наполовину восстановленным он вас не оставит. Если файл восстановить нельзя, вам сообщат, какой именно и почему.
Лимиты и приостановка
Чекпоинты хранятся 30 дней, с ограничением 200 резервных копий на сессию. Копии лежат в ~/.commandcode/file-history/<session-id>/, и идентичное содержимое хранится один раз, сколько бы чекпоинтов на него ни ссылалось.
Примечание
Размер резервной копии файла ограничен 10 МБ на файл. Слишком большой файл никогда не читается и не копируется, а поскольку он не был захвачен, откат оставляет его ровно как есть, а не удаляет. Когда сессия достигает предела в 200 копий или проходит 30 дней, старые чекпоинты выбывают.
WARNING
Если на диске заканчивается место, создание чекпоинтов приостанавливается для всей сессии, а не деградирует молча от файла к файлу, и вы увидите уведомление. Уже сделанные чекпоинты остаются рабочими, а создание чекпоинтов возобновляется само, со вторым уведомлением, когда места снова достаточно.
Устранение неполадок
Чекпоинты не появляются
- Убедитесь, что в сессии отправлено хотя бы одно сообщение.
- Проверьте, не приостановлено ли создание чекпоинтов (вы должны были увидеть уведомление о нехватке места на диске).
- Убедитесь, что в сессии были изменения файлов; чекпоинт без изменений файлов предлагает только восстановление беседы.
Восстановление не удалось
- Посмотрите в сообщении об ошибке, какой файл не удалось восстановить.
- Убедитесь, что файлы резервных копий не были удалены вручную из
~/.commandcode/file-history/. - Проверьте, что у вас есть права на запись в целевые файлы.
Двойной Esc не работает
- Нажмите Esc дважды в течение 500 мс.
- Убедитесь, что фокус находится в поле ввода Command Code.
- Используйте вместо этого
/rewind.
См. также
- Сессии и чекпоинты: транскрипты, возобновление, форки и клонирование, скретчпад, экспорт.
- Контекст и компактация: история сессии только на добавление, которую компактация никогда не перезаписывает.
Источник
Сверено с оригиналом 13 ноября 2026.