Контрольные точки¶

Checkpointing сохраняет локальные снимки перед вызовами инструментов, которые меняют файлы. Это полезно, когда агент применяет серию правок, а затем нужно быстро вернуться к состоянию до конкретного действия.

Включается флагом --checkpointing (см. аргументы) или настройкой checkpointing.enabled (см. настройки).

Включение¶

На один запуск:

koda --checkpointing

Постоянно через настройки:

~/.kodacli/settings.json

{
  "checkpointing": {
    "enabled": true
  }
}

Для работы нужен Git. Koda CLI не коммитит в ваш основной репозиторий: он создаёт отдельное shadow-хранилище.

Где хранятся данные¶

Данные	Путь
Shadow git history	`~/.kodacli/history/<project_hash>`
Checkpoint metadata	`~/.kodacli/tmp/<project_hash>/checkpoints`

Checkpoint содержит снимок файлов, историю чата и описание вызова инструмента, перед которым был сделан снимок. Все данные хранятся локально на вашей машине и не попадают в основной Git-репозиторий проекта.

Восстановление¶

Показать список checkpoint-ов текущего проекта:

/restore

Восстановить конкретный checkpoint:

/restore <checkpoint_file>

Команда /restore регистрируется только если checkpointing включён

После восстановления CLI возвращает файлы и историю сессии к состоянию перед выбранным вызовом инструмента.

Практические советы¶

Включайте checkpointing перед задачами с большим числом правок.
Не используйте checkpointing как замену Git: он помогает откатить действия агента, но не заменяет нормальную историю изменений.
Если проект большой, shadow repo может занимать заметное место в ~/.kodacli/history.