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

Команда koda запускает интерактивную TUI-сессию в текущей рабочей директории. CLI собирает контекст проекта, загружает KODA.md или 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, домашней директории и расширениях.

Файлы инструкций проекта¶

В каждом каталоге CLI использует первый найденный файл в порядке KODA.md → AGENTS.md → agents.md → AGENT.md. Список можно заменить настройкой contextFileName. Подробнее о формате и назначении таких файлов — в разделе Контекстные файлы.

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

• После успешного read_file к результату добавляются инструкции всех каталогов от корня рабочей области до каталога файла.
• После list_directory добавляются инструкции до самого каталога; соседние каталоги не затрагиваются.
• Инструкции приходят в блоке <system-reminder> с атрибутами file и scope и действуют только для файлов внутри scope.
• Повторно уже доставленный файл не добавляется. После сжатия контекста инструкции придут снова при следующем чтении в их каталоге.
• replace и write_file не меняют файл, пока инструкции его каталогов не доставлены в предыдущих ответах. Агент получает ошибку со списком файлов, которые нужно прочитать.
• На инструкции одного чтения отводится до 32 КиБ. Слишком большой файл приходит началом с подсказкой продолжить чтение через offset.
• Файлы подкаталогов, исключённые .kodaignore, не доставляются и не требуются для записи. Вместо исключённого файла используется следующее имя из списка. Файл в корне рабочей области загружается всегда.
• Каталоги из .gitignore по умолчанию не исключаются. Чтобы исключить их, включите fileFiltering.respectGitIgnore.
• Файл-симлинк, например AGENTS.md -> CLAUDE.md, считается файлом своего каталога под своим именем. Если он уже есть в системном промпте или истории, он не требуется и не доставляется повторно.

Файл, который начинается с # [DISABLED], не загружается, но занимает свой каталог: другой файл инструкций в этом каталоге не подставится вместо него.

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

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

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

/help¶

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

/clear¶

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

/quit¶

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

/model¶

koda-base KODA_MODEL

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

/compress¶

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

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

/theme¶

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