Управление сессиями¶

Сессия — это один запуск интерактивного режима Koda CLI. Каждой сессии присваивается идентификатор (Session ID), а внутри неё накапливается история разговора и контекст.

По умолчанию история живёт только в памяти процесса. Чтобы вернуться к разговору после выхода из CLI, сохраните его чекпоинтом.

Идентификатор сессии¶

Идентификатор текущей сессии показывается командой /stats.

Он нужен при диагностике проблем: например, /bug log generate включает Session ID в JSON-лог сессии.

Подробности на странице команд.

Сохранение и восстановление разговора¶

Историю разговора можно сохранить чекпоинтом и восстановить позже — в том же или новом запуске CLI.

Команды группы /chat (см. справочник):

Команда	Действие
`/chat save <тег>`	Сохраняет текущую историю разговора
`/chat list`	Показывает сохранённые чекпоинты с датами
`/chat resume <тег>`	Восстанавливает разговор
`/chat delete <тег>`	Удаляет чекпоинт

Пример:

/chat save refactor-auth
/chat resume refactor-auth

Правила и особенности:

Тег может содержать буквы, цифры, -, _ и ..
Сохранить можно только разговор с историей: если вы ещё ничего не обсуждали, CLI сообщит об этом.
При повторном сохранении с тем же тегом CLI попросит подтвердить перезапись.
Имена тегов дополняются по Tab в командах /chat resume и /chat delete.
У /chat resume есть алиас /chat load.

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

Все данные хранятся локально на вашей машине.

Данные	Путь
Чекпоинты разговора	`~/.kodacli/tmp/<project_hash>/checkpoint-<тег>.json`
Снимки файлов (checkpointing)	`~/.kodacli/history/<project_hash>`
ACP-сессии (редакторы)	`~/.koda/acp/sessions/`
Сессии Telegram-режима	`~/.kodacli/telegram-remote/sessions/`

Каталог для ACP-сессий можно переопределить переменной окружения KODA_ACP_SESSION_STORE_DIR.

Очистка и сжатие¶

/clear — очищает экран и сбрасывает историю разговора, начиная сессию заново.
/compress (алиас /summarize) — заменяет накопленный контекст кратким резюме, не завершая сессию.

Подробности на странице о сжатии контекста.