Cheatsheet¶
Компактный справочник всех команд, флагов и подкоманд Koda CLI.
Основной запуск¶
Подробнее — на странице использование CLI и в разделе неинтерактивный режим.
| Команда | Описание |
|---|---|
koda |
открыть интерактивную сессию |
koda -p "запрос" |
выполнить запрос и завершить процесс |
koda -i "запрос" |
выполнить запрос и остаться в интерактиве |
cat file \| koda -p "объясни" |
передать содержимое файла через pipe |
koda --version |
показать версию (алиас -v) |
koda --help |
показать справку (алиас -h) |
Полезные опции запуска¶
Подробное описание на странице об аргументах.
| Опция | Алиас | Описание |
|---|---|---|
--model <id> |
-m |
выбрать модель |
--prompt <text> |
-p |
запрос в неинтерактивном режиме; stdin добавляется к запросу |
--prompt-interactive <text> |
-i |
выполнить запрос и оставить TUI открытым |
--sandbox |
-s |
запустить CLI в песочнице |
--sandbox-image <uri> |
образ для Docker/Podman | |
--debug |
-d |
включить отладочный режим |
--all-files |
-a |
включить все найденные файлы в контекст |
--show-memory-usage |
показывать использование памяти в статусной строке | |
--show-reasoning |
выводить reasoning модели в stderr в неинтерактивном режиме | |
--approval-mode <mode> |
default, auto_edit или yolo |
|
--yolo |
-y |
алиас для --approval-mode=yolo |
--checkpointing |
-c |
включить контрольные точки изменений файлов |
--acp |
--experimental-acp |
запустить агент в ACP-режиме для IDE-клиента |
--allowed-mcp-server-names <names...> |
ограничить набор MCP-серверов | |
--extensions <names...> |
-e |
включить только указанные расширения; none отключает все |
--list-extensions |
-l |
вывести доступные расширения и выйти |
--proxy <url> |
прокси для Koda client | |
--include-directories <dirs...> |
добавить каталоги в рабочую область; можно через запятую |
Слеш-команды¶
Команды внутри интерактивной сессии начинаются с /.
Подробное описание каждого флага — на странице о slash-командах.
Управление сессией¶
Подробнее — на странице управление сессиями и о сжатии контекста.
| Команда | Описание |
|---|---|
/help |
показать справку (алиас /?) |
/quit |
выйти из CLI (алиас /exit) |
/clear |
очистить экран и видимую историю |
/compress |
заменить контекст кратким резюме (алиас /summarize) |
/copy |
копировать последний ответ в буфер обмена |
/about |
показать версию, git commit, модель, ОС и способ входа |
/stats |
показать статистику сессии (алиас /usage) |
/stats model |
статистика по моделям |
/stats tools |
статистика по инструментам |
/limits |
показать лимиты Koda Auth |
Планирование¶
Подробнее — на странице о режиме планирования.
| Команда | Описание |
|---|---|
/plan |
включить режим планирования |
/plan <запрос> |
включить режим и сразу отправить запрос |
/plan show |
показать текущий план |
/plan implement |
запустить реализацию плана в режиме агента |
/plan clear |
удалить план, не меняя режим |
/plan exit |
вернуться в режим агента без запуска реализации (алиас /plan off) |
Настройки и вход¶
Подробнее — на страницах авторизация, модели, конфигурация, темы и Vim-режим.
| Команда | Описание |
|---|---|
/auth |
открыть диалог выбора способа входа |
/model |
выбрать модель |
/maxcontext |
настроить максимальный контекст модели |
/reasoning |
выбрать уровень размышлений модели (алиас /effort) |
/reasoning-display |
выбрать режим отображения размышлений |
/settings |
открыть редактор настроек |
/editor |
выбрать внешний редактор |
/vim |
переключить режим vim |
/docs |
открыть документацию в браузере |
Контекст и файлы¶
Подробнее — на странице добавление файлов.
| Команда | Описание |
|---|---|
/directory add <paths> |
добавить каталоги в рабочую область (алиас /dir) |
/directory show |
показать каталоги текущей рабочей области |
/memory show |
показать загруженную память |
/memory add <текст> |
добавить факт в глобальный ~/.kodacli/KODA.md |
/memory refresh |
заново загрузить память |
/init |
сгенерировать KODA.md на основе анализа проекта |
Инструменты и MCP¶
Подробнее — на страницах MCP-серверы и расширения.
| Команда | Описание |
|---|---|
/tools |
показать доступные инструменты |
/mcp list |
вывести MCP-серверы, инструменты и prompts |
/mcp auth <server> |
OAuth-аутентификация для MCP-сервера |
/mcp refresh |
переобнаружить MCP-серверы и инструменты |
/extensions |
показать активные расширения текущей сессии |
/subagents |
показать задачи фоновых субагентов текущей сессии (алиас /subagent) |
/subagents show <id> |
показать полный результат одной задачи |
/subagents cancel <id\| all> |
отменить один или все запущенные субагенты |
/subagents continue <id> |
продлить время работы зависшего субагента |
/subagents prompt <id> <текст> |
отправить сообщение завершённому субагенту |
/subagents compress <id> |
сжать историю завершённого субагента в одно резюме |
/subagents restart <id> |
повторить завершённую или продолжить прерванную |
/subagents roles |
показать каталог ролей субагентов |
@agent:<имя> |
явно запустить роль субагента в начале сообщения |
Навыки¶
Подробнее — на странице навыки агента.
| Команда | Описание |
|---|---|
/skills list |
показать обнаруженные навыки |
/skills enable <name> |
включить навык |
/skills disable <name> |
отключить навык |
/skills reload |
перечитать навыки с диска |
Чаты и checkpointing¶
Подробнее — на страницах управление сессиями и контрольные точки.
| Команда | Описание |
|---|---|
/chat save <тег> |
сохранить текущую историю разговора |
/chat resume <тег> |
восстановить сохранённый разговор (алиас /chat load) |
/chat list |
показать сохранённые checkpoint-и разговора |
/chat delete <тег> |
удалить checkpoint разговора |
/restore [id] |
восстановить файлы из checkpoint-а (при включённом checkpointing) |
IDE-интеграция¶
Подробнее — на странице компаньон для IDE.
| Команда | Описание |
|---|---|
/ide status |
показать статус IDE-интеграции |
/ide install |
открыть страницу загрузки компаньона |
/ide enable |
включить IDE mode |
/ide disable |
выключить IDE mode |
Удалённый доступ¶
Подробнее — на странице интеграция с Telegram.
| Команда | Описание |
|---|---|
/telegram |
открыть мастер настройки (алиас /tg) |
/telegram setup <bot-token> |
задать токен бота и включить доступ |
/telegram status |
показать состояние доступа |
/telegram enable / disable |
включить или выключить доступ |
/telegram link / relink |
привязать владельца или начать привязку заново |
/telegram unlink |
отвязать текущего владельца |
Отчёт об ошибке¶
Как сообщить об ошибке — в разделе диагностика.
| Команда | Описание |
|---|---|
/bug [тема] |
открыть страницу отчёта об ошибке |
/bug log generate |
записать JSON-лог сессии (алиас /bug logs generate) |
Терминал Kitty¶
Подробнее — на странице интеграция с Kitty.
| Команда | Описание |
|---|---|
/kitty-integration |
установить, диагностировать и проверить интеграцию (только внутри Kitty) |
Спецсимволы в вводе¶
Подробнее — в разделах команды с @ и режим оболочки справочника команд.
| Символ | Описание |
|---|---|
@<путь> |
добавить содержимое файла или каталога в запрос |
!<команда> |
выполнить shell-команду и вернуться в CLI |
! |
переключить режим оболочки (ввод интерпретируется как shell) |
Подкоманды¶
Подкоманды выполняются однократно, выводят результат и завершают процесс.
koda mcp — управление MCP-серверами¶
Подробнее — на странице MCP-серверы и с примерами подключения.
| Команда | Описание |
|---|---|
koda mcp add <name> <commandOrUrl> [args...] |
добавить или обновить сервер |
koda mcp remove <name> |
удалить сервер |
koda mcp list |
показать серверы и статус |
Опции koda mcp add:
| Опция | Алиас | Значения | Описание |
|---|---|---|---|
--scope |
-s |
user, project |
область настроек (по умолчанию project) |
--transport |
-t |
stdio, sse, http |
тип транспорта (по умолчанию stdio) |
--env |
-e |
KEY=value |
переменные окружения для stdio |
--header |
-H |
Header: value |
HTTP-заголовки для sse и http |
--timeout |
число (мс) | таймаут подключения | |
--trust |
true / false |
пропускать подтверждения вызовов инструментов | |
--description |
строка | описание сервера | |
--include-tools |
список через запятую | разрешить только перечисленные инструменты | |
--exclude-tools |
список через запятую | скрыть перечисленные инструменты |
koda extensions — управление расширениями¶
Подробнее — на странице расширения.
| Команда | Описание |
|---|---|
koda extensions install <source> |
установить из git-URL |
koda extensions install --path <dir> |
установить из локальной директории |
koda extensions uninstall <name> |
удалить расширение |
koda extensions list |
показать установленные расширения |
koda extensions update <name> |
обновить расширение |
koda extensions enable <name> [--scope S] |
включить расширение |
koda extensions disable <name> [--scope S] |
отключить расширение |
koda skills — управление навыками¶
Подробнее — на странице навыки агента.
| Команда | Описание |
|---|---|
koda skills list |
показать обнаруженные навыки |
koda skills install <source> [--path P] [--scope S] |
установить из git, директории или .skill |
koda skills uninstall <name> [--scope S] |
удалить навык |
koda skills enable <name> [--scope S] |
включить навык |
koda skills disable <name> [--scope S] |
отключить навык |
Аргумент --scope принимает user, project или workspace (project и workspace равнозначны).
koda integrations kitty — интеграция с терминалом Kitty¶
Подробнее — на странице интеграция с Kitty.
| Команда | Описание |
|---|---|
koda integrations kitty install |
установить интеграцию |
koda integrations kitty status |
показать состояние интеграции и параметры чата |
koda integrations kitty uninstall |
удалить интеграцию |
koda integrations kitty suggest |
проанализировать последнюю неудачную команду |
koda integrations kitty chat |
открыть чат об истории терминала |
koda integrations kitty configure |
изменить параметры чата |
koda integrations kitty auto <enable\|disable> |
включить или выключить автоматический анализ ошибок |
koda integrations kitty service <status\|start\|stop\|restart> |
управлять фоновым сервисом |
Переменные окружения¶
Полный список — в разделе переменные окружения справочника конфигурации.
| Переменная | Описание |
|---|---|
KODA_MODEL |
модель по умолчанию |
KODA_SANDBOX |
включить песочницу (приоритет над флагом и настройками) |
KODA_SANDBOX_IMAGE |
образ песочницы для Docker/Podman |
HTTPS_PROXY |
HTTP-прокси |
HTTP_PROXY |
HTTP-прокси |
NO_BROWSER |
не открывать браузер при входе (для SSH/серверов) |
DEBUG / DEBUG_MODE |
включить отладочный режим (значение true или 1) |
OTEL_EXPORTER_OTLP_ENDPOINT |
OTLP-адрес для телеметрии |
Файлы настроек¶
Подробнее — на странице о конфигурации, а про slash-команды — на странице пользовательские slash-команды.
| Файл | Назначение |
|---|---|
~/.kodacli/settings.json |
пользовательские настройки |
<рабочая область>/.kodacli/settings.json |
настройки проекта |
~/.kodacli/KODA.md |
глобальная проектная память |
<рабочая область>/KODA.md |
проектная память |
<рабочая область>/AGENTS.md |
проектная память (альтернатива) |
~/.config/koda/credentials.json |
данные входа |
~/.kodacli/commands/ |
пользовательские слеш-команды |
<рабочая область>/.kodacli/commands/ |
слеш-команды проекта |
Подробнее — на странице о конфигурации.