Skip to content

Чекпоинты и откат ​

Каждый отправленный промпт открывает чекпоинт: снимок беседы плюс резервную копию каждого файла, который Command Code затем отредактирует. Если что-то пошло не так, откатитесь к любому более раннему чекпоинту и продолжайте оттуда.

Как открыть интерфейс отката ​

Нажмите Esc дважды в течение 500 мс или выполните:

bash
/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

Если на диске заканчивается место, создание чекпоинтов приостанавливается для всей сессии, а не деградирует молча от файла к файлу, и вы увидите уведомление. Уже сделанные чекпоинты остаются рабочими, а создание чекпоинтов возобновляется само, со вторым уведомлением, когда места снова достаточно.

Устранение неполадок ​

Чекпоинты не появляются ​

  1. Убедитесь, что в сессии отправлено хотя бы одно сообщение.
  2. Проверьте, не приостановлено ли создание чекпоинтов (вы должны были увидеть уведомление о нехватке места на диске).
  3. Убедитесь, что в сессии были изменения файлов; чекпоинт без изменений файлов предлагает только восстановление беседы.

Восстановление не удалось ​

  1. Посмотрите в сообщении об ошибке, какой файл не удалось восстановить.
  2. Убедитесь, что файлы резервных копий не были удалены вручную из ~/.commandcode/file-history/.
  3. Проверьте, что у вас есть права на запись в целевые файлы.

Двойной Esc не работает ​

  1. Нажмите Esc дважды в течение 500 мс.
  2. Убедитесь, что фокус находится в поле ввода Command Code.
  3. Используйте вместо этого /rewind.

См. также ​

Источник

Сверено с оригиналом 13 ноября 2026.