Встроенные слеш-команды¶

Koda CLI поддерживает несколько встроенных команд, которые помогают управлять сессией, настраивать интерфейс и контролировать его поведение. Эти команды начинаются с косой черты (/), символа @ или восклицательного знака (!).

Команды с косой чертой (/)¶

Команды с косой чертой предоставляют мета-уровень управления самим CLI. Каждая команда ниже описана отдельной секцией.

/about¶

Показывает версию CLI, git commit, модель, ОС и способ входа.

/auth¶

Открывает диалог выбора способа входа.

/bug [тема]¶

Открывает страницу отчёта об ошибке. Подкоманда /bug log generate пишет JSON-лог сессии.

/chat¶

Управление сохранённой историей разговора.

/chat save <тег>¶

Сохраняет текущую историю разговора.

/chat resume <тег>¶

Восстанавливает сохранённый разговор. Алиас: /chat load.

/chat list¶

Показывает сохранённые checkpoint-и разговора.

/chat delete <тег>¶

Удаляет checkpoint разговора.

/clear¶

Очищает экран и видимую историю сессии.

/compress¶

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

/copy¶

Копирует последний ответ в буфер обмена.

/directory¶

Управление каталогами рабочей области (workspace).

/directory add <paths>¶

Добавляет каталоги в workspace. Алиас: /dir.

/directory show¶

Показывает каталоги текущего workspace.

/docs¶

Открывает документацию в браузере.

/editor¶

Выбирает внешний редактор.

/environment¶

Переключает внутреннее окружение Koda: prod, stage или dev. Окружение определяет адреса API и сервисов авторизации.

Обычно используется для отладки: в обычной работе переключать окружение не нужно. Выбранное окружение сохраняется в переменной окружения KODA_ENVIRONMENT текущего процесса; после смены перезапустите сессию, чтобы все запросы ушли в новое окружение.

/extensions¶

Показывает активные extensions текущей сессии.

/help¶

Показывает справку. Алиас: /?.

/ide¶

Управление IDE-интеграцией.

/ide status¶

Показывает статус IDE-интеграции.

/ide install¶

Открывает страницу загрузки companion.

/ide enable / /ide disable¶

Включает или выключает IDE mode.

/init¶

Анализирует текущий каталог и генерирует настроенный файл контекста KODA.md. Это облегчает предоставление инструкций, специфичных для проекта, агенту Koda.

/limits¶

Показывает лимиты Koda Auth.

/mcp¶

Управление MCP-серверами.

/mcp list¶

Выводит MCP-серверы, tools и prompts.

/mcp auth <server>¶

OAuth-аутентификация для MCP-сервера.

/mcp refresh¶

Переобнаруживает MCP-серверы и tools.

/memory¶

Управление памятью.

/memory show¶

Показывает загруженную память.

/memory add <текст>¶

Добавляет факт в глобальный ~/.kodacli/KODA.md.

/memory refresh¶

Заново загружает память.

/model¶

Выбирает Koda-модель или OpenAI-совместимую кастомную. Выберите модель, которую использует CLI, и область применения изменения (пользовательские, рабочие или системные настройки). Используйте Enter для выбора модели и Tab для переключения области.

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

• Выберите пункт [+] Добавить свою модель (OpenAI-совместимый) внизу списка.
• Укажите идентификатор модели, базовый URL провайдера (по умолчанию https://api.openai.com/v1) и API-ключ этого провайдера.
• CLI попытается проверить модель через <baseUrl>/models, но сохранит запись, даже если эндпоинт недоступен.
• Сохранённые модели лежат в ~/.config/koda/credentials.json.

Чтобы отредактировать или удалить кастомную модель:

• Выберите кастомную модель в списке (они помечены как {model} (custom)).
• Нажмите E, чтобы отредактировать модель, D — чтобы удалить её. Если удалённая модель была активной, CLI автоматически переключится на встроенную.
• В окне редактирования используйте Enter для перехода или сохранения, Tab для смены поля, Esc для отмены.

/plan¶

Включает режим планирования: рабочая область становится доступной только для чтения, а результатом работы агента становится опубликованный план.

/plan             включить режим планирования
/plan <запрос>    включить режим и сразу отправить запрос
/plan show        показать текущий план
/plan implement   запустить реализацию плана в режиме агента
/plan clear       удалить план, не меняя режим
/plan exit        вернуться в режим агента без запуска реализации

/privacy¶

Показывает уведомление о приватности.

/quit¶

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

/reasoning¶

Выбирает уровень размышлений (reasoning effort) для текущей модели. Алиас: /effort.

/reasoning        открыть диалог выбора уровня
/reasoning high   установить уровень high

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

/reasoning-display¶

Выбирает, сколько текста размышлений модели показывать в терминале. Эквивалент /reasoning display <режим>; доступные режимы — off, compact, stream, full.

/restore [id]¶

Восстанавливает файлы из checkpoint-а tool call. Доступно при checkpointing.

/settings¶

Открывает редактор настроек.

/setup-github¶

Настраивает GitHub Actions для репозитория.

/skills¶

Управление skills.

/skills list¶

Показывает обнаруженные skills.

/skills enable <name>¶

Включает skill.

/skills disable <name>¶

Отключает skill.

/skills reload¶

Перечитывает skills с диска.

/subagents¶

Управление фоновыми субагентами — исследовательскими задачами, которые агент делегирует инструменту run_subagent.

Субагенты работают в фоне и не блокируют основной диалог: пока субагент исследует задачу, вы можете продолжать общение с агентом. Команда доступна, когда субагенты включены настройкой subagents.enabled.

/subagents или /subagents list¶

Показывает задачи субагентов текущей сессии: статус, число шагов, время работы, роль и занятость контекста каждой. Для каждой задачи выводится task_id, который используется в остальных подкомандах.

/subagents show <task_id>¶

Печатает полный результат одной задачи: описание, статус, модель и итоговый ответ субагента.

/subagents cancel <task_id|all>¶

Отменяет один запущенный субагент или все запущенные задачи текущей сессии. Результат отмены доставляется агенту, чтобы он не ждал ответа бесконечно.

/subagents continue <task_id>¶

Продлевает время работы субагента, который долго не присылал шаги и помечен как stalled. Без продления watchdog остановит задачу по истечении бюджета.

/subagents prompt <task_id> [--policy read_only|auto_edit|yolo] <message>¶

Отправляет завершённому субагенту собственное сообщение: он сохраняет историю и описание задачи, но отвечает вам, а не агенту. Ответ можно прочитать командой /subagents show или в панели агентов.

Флаг --policy задаёт инструменты на один ход: read_only (по умолчанию), auto_edit — добавляет правку и создание файлов, yolo — ещё и выполнение команд.

/subagents compress <task_id>¶

Заменяет всю историю завершённого субагента одним резюме и показывает счётчик токенов «до → после». Работающего субагента сначала нужно остановить.

/subagents restart <task_id>¶

Прогоняет завершённую задачу заново или продолжает прерванную.

/subagents roles [enable|disable|create|delete] <имя>¶

Каталог ролей субагентов и управление ими:

/subagents roles                          показать каталог ролей
/subagents roles enable <имя>             включить роль
/subagents roles disable <имя>            выключить роль, не трогая файл
/subagents roles create <имя> [--global]  создать файл роли из шаблона
/subagents roles delete <имя>             удалить файл роли

Роль запускается явно меткой @agent:<имя> в начале абзаца сообщения.

/stats¶

Показывает статистику сессии. Алиас: /usage.

/stats model¶

Показывает статистику по моделям.

/stats tools¶

Показывает статистику по tools.

/telegram¶

Управление удалённым доступом через Telegram.

/telegram                        открыть мастер настройки
/telegram setup <bot-token>      задать токен бота и включить доступ
/telegram status                 показать состояние доступа
/telegram enable / disable       включить или выключить доступ
/telegram link / relink          привязать владельца или начать привязку заново
/telegram unlink                 отвязать текущего владельца

/terminal-setup¶

Настраивает терминал для корректной работы клавиатурных сочетаний. Выполняется один раз для поддерживаемых терминалов.

/theme¶

Выбирает тему интерфейса.

/tools¶

Показывает доступные tools. Описание каждого инструмента — в справочнике инструментов.

/vim¶

Переключает режим vim вкл. или выкл. Когда режим vim включен, область ввода поддерживает навигацию и команды редактирования в стиле vim в режимах NORMAL и INSERT.

• NORMAL режим: навигация с h, j, k, l; переход по словам с w, b, e; переход к началу/концу строки с 0, $, ^; переход к определенным строкам с G (или gg для первой строки).
• INSERT режим: обычный ввод текста с возможностью выхода в NORMAL режим.
• Команды редактирования: удаление с x, изменение с c, вставка с i, a, o, O; сложные операции как dd, cc, dw, cw.
• Поддержка счёта: применение команд с цифрами (например, 3h, 5w, 10G).
• Повтор последней команды: используйте ., чтобы повторить последнюю операцию редактирования.
• Индикатор статуса: при включении показывает [NORMAL] или [INSERT] в нижнем колонтитуле.

Пользовательские слеш-команды¶

Koda CLI загружает пользовательские команды из:

1. ~/.kodacli/commands/;
2. <workspace>/.kodacli/commands/;
3. commands/ внутри активных extensions;
4. prompts из MCP-серверов.

Файл команды должен быть TOML-файлом:

description = "Проверить staged diff"
prompt = """
Проанализируй staged changes и перечисли риски перед commit.
"""

Путь задаёт имя команды: .kodacli/commands/git/review.toml становится /git:review. Если в prompt есть {{args}}, CLI подставит туда текст после имени команды. Если {{args}} нет, аргументы будут добавлены в конец prompt.

Команды могут выполнять shell-вставки через !{...}. Перед выполнением CLI покажет подтверждение, а глобальные excludeTools и coreTools продолжают применяться.

Команды с @¶

Команды с @ используются для включения содержимого файлов или каталогов как части вашей подсказки для Koda. Эти команды включают фильтрацию с учётом git.

@<путь_к_файлу_или_каталогу>¶

Вставьте содержимое указанного файла или файлов в ваш текущий запрос. Это полезно для задания вопросов о конкретном коде, тексте или коллекциях файлов.

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

Пробелы в путях должны быть экранированы обратной косой чертой (например, @My\ Documents/file.txt). Если путь не указан, то символ @ отправится модели как есть.

Команда использует инструмент read_many_files внутри. Содержимое загружается, а затем вставляется в ваш запрос перед отправкой модели Koda.

Примеры:

• запусти проект согласно инструкций в @README.md
• @path/to/your/file.txt объясни этот текст
• @src/my_project/ где в этом каталоге обработчик событий?

Фильтрация с учётом git: по умолчанию исключаются файлы, игнорируемые git (например, node_modules/, dist/, .env, .git/). Это поведение можно изменить с помощью настроек fileFiltering.

Типы файлов: команда предназначена для текстовых файлов. Хотя она может попытаться прочитать любой файл, двоичные файлы или очень большие файлы могут быть пропущены или усечены внутренним инструментом read_many_files, чтобы обеспечить производительность и актуальность. Инструмент указывает, были ли файлы пропущены.

Обработка ошибок для команд @¶

Если путь, указанный после @, не найден или недействителен, будет отображено сообщение об ошибке, и запрос может не быть отправлен модели Koda, или будет отправлен без содержимого файла. Если инструмент read_many_files сталкивается с ошибкой (например, проблемы с разрешениями), это также будет сообщено.

Режим оболочки и сквозные команды (!)¶

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

!<команда_оболочки>¶

Выполнить заданную <команду_оболочки> с помощью bash на Linux/macOS или cmd.exe на Windows. Любой вывод или ошибки команды отображаются в терминале.

Примеры:

• !ls -la — выполняет ls -la и возвращается в Koda CLI;
• !git status — выполняет git status и возвращается в Koda CLI.

! (Переключение режима оболочки)¶

Ввод ! сам по себе переключает режим оболочки. В активном состоянии режим оболочки использует другую раскраску и индикатор режима оболочки. В режиме оболочки текст, который вы вводите, интерпретируется напрямую как команда оболочки. При выходе интерфейс возвращается к стандартному внешнему виду, и возобновляется нормальное поведение Koda CLI.