Использование CLI¶

Команда koda запускает интерактивную TUI-сессию в текущей рабочей директории. CLI собирает контекст проекта, загружает KODA.md или подключённый через настройку contextFileName файл AGENTS.md, подключает доступные инструменты, MCP-серверы, расширения и навыки, а затем ведёт диалог с моделью Koda.

Для согласования подхода перед изменениями можно включить режим планирования: агент исследует проект в режиме read-only и публикует план.

Основные команды запуска¶

koda
koda -p "Кратко объясни этот проект"
koda -i "Найди слабые места в тестах"
koda --include-directories ../library,../docs
koda --checkpointing

• -p, --prompt — выполняет запрос и завершает процесс.
• -i, --prompt-interactive — выполняет начальный запрос и оставляет интерактивную сессию открытой.
• --include-directories — добавляет соседние директории в рабочий контекст.
• --checkpointing — включает сохранение контрольных точек перед изменением файлов.

Неинтерактивный режим¶

Koda CLI может работать в неинтерактивном режиме, что полезно для сценариев и автоматизации. В этом режиме вы подаёте ввод в CLI, он выполняет команду, а затем завершает работу.

Следующий пример передаёт команду в Koda CLI из вашего терминала:

echo "Что такое тонкая настройка?" | koda

Koda CLI выполняет команду и выводит результат в ваш терминал. Обратите внимание, что вы можете достичь такого же поведения, используя флаг --prompt или -p:

koda -p "Что такое тонкая настройка?"

В неинтерактивном режиме -p содержимое stdin добавляется к запросу, после чего процесс завершается. Это удобно для shell-скриптов и пайплайнов CI/CD.

Контекст проекта¶

CLI учитывает:

• основной каталог запуска;
• дополнительные каталоги из --include-directories и настройки includeDirectories;
• глобальный ~/.kodacli/KODA.md и проектные файлы KODA.md или AGENTS.md;
• файлы контекста из активных расширений;
• открытые файлы и выделение из IDE, если включена интеграция;
• MCP-инструменты и prompts — см. MCP-серверы;
• навыки, доступные в .kodacli/skills, .agents/skills, домашней директории и расширениях.

Слеш-команды¶

Внутри сессии Koda CLI доступны команды, которые начинаются с косой черты (/). Они помогают управлять сессией, настраивать интерфейс и контролировать поведение агента.

Каждая команда ниже описана отдельной секцией с указанием алиасов и особенностей.

/help¶

Показывает справку по доступным командам и горячим клавишам. Алиас: /?.

/clear¶

Очищает экран и видимую историю сессии. Контекст модели не сбрасывается — чтобы сжать его, используйте /compress.

/quit¶

Выходит из CLI. Алиас: /exit.

/model¶

koda-base KODA_MODEL

Выбирает модель для диалога. Область изменения (пользовательские, рабочие или системные настройки) переключается клавишей Tab, выбор — Enter. Подробнее о моделях и уровне размышлений — на странице модели.

/compress¶

Заменяет накопленный контекст кратким резюме. Алиас: /summarize.

Полезно, когда сессия длинная и контекст приближается к лимиту. Подробнее о том, как работает сжатие, — на странице о сжатии контекста.

/theme¶

Выбирает тему интерфейса. Встроенные темы перечислены в списке; пользовательские темы задаются в settings.json.