Команды¶

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

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

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

/bug¶

Сообщить о проблеме с Koda CLI.

/chat¶

Сохраняйте и возобновляйте историю переписки для разветвления состояния переписки интерактивно или возобновления предыдущего состояния из более поздней сессии.

/chat save <тег>¶

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

Вы должны добавить <тег> для идентификации состояния переписки.

По умолчанию сохраненные контрольные точки переписки находятся в:

• Linux/macOS: ~/.kodacli/tmp/<хеш_проекта>/checkpoints/
• Windows: C:\Users\<ИмяПользователя>\.kodacli\tmp\<хеш_проекта>\checkpoints\

При выполнении /chat list CLI сканирует только эти конкретные каталоги, чтобы найти доступные контрольные точки.

Эти контрольные точки предназначены для ручного сохранения и восстановления состояний переписки.

Для автоматических контрольных точек, создаваемых перед изменением файлов, см. документацию по контрольным точкам.

/chat resume <тег>¶

Возобновляет переписку из предыдущего сохранения.

/chat list¶

Перечисляет доступные теги для восстановления состояния переписки.

/chat delete <тег>¶

Удаляет сохраненную контрольную точку переписки.

/clear¶

Очищает экран терминала, включая видимую историю сеанса и буфер прокрутки в CLI. В зависимости от реализации, основные данные сеанса (для вызова истории) могут сохраняться, но визуальное отображение очищается.

Нажмите Ctrl + L в любое время, чтобы выполнить очистку.

/compress¶

Заменить весь контекст чата резюме. Это экономит токены, используемые для последующих задач, сохраняя при этом краткое резюме произошедшего.

/copy¶

Копирует последний вывод, созданный Koda CLI, в ваш буфер обмена для легкого обмена или повторного использования.

/directory, /dir¶

Управление каталогами рабочей области для поддержки нескольких каталогов.

/dir add <path1>,<path2>¶

Добавить каталог в рабочую область.

Путь может быть абсолютным или относительным к текущему рабочему каталогу. Также поддерживается ссылка из домашнего каталога.

Отключено в ограничительных профилях песочницы. Если вы используете их, используйте --include-directories при запуске сессии вместо этого.

/dir show¶

Показать все каталоги, добавленные с помощью /directory add и --include-directories.

editor¶

Открыть диалог для выбора поддерживаемых редакторов.

help, /?¶

Отобразить справочную информацию о Koda CLI, включая доступные команды и их использование.

mcp¶

Перечислить настроенные серверы протокола контекста моделей (MCP), их статус подключения, сведения о сервере и доступные инструменты.

/mcp desc, /mcp descriptions¶

Показать подробные описания серверов MCP и инструментов.

/mcp nodesc, /mcp nodescriptions¶

Скрыть описания инструментов, показывая только их названия.

/mcp schema¶

Показать полную схему JSON для настроенных параметров инструмента.

Нажмите Ctrl + T в любое время, чтобы переключиться между показом и скрытием описаний инструментов.

/memory¶

Управление контекстом инструкций ИИ (иерархическая память, загруженная из контекстных файлов).

/memory add <текст для запоминания>¶

Добавляет следующий текст в память ИИ.

/memory show¶

Отобразить полное объединенное содержимое текущей иерархической памяти, которое было загружено из всех контекстных файлов. Это позволяет вам проверить контекст инструкций, предоставляемый модели Koda.

/memory refresh¶

Перезагрузить иерархическую инструктивную память из всех контекстных файлов, найденных в настроенных местоположениях (глобальных, проектных/предков и подкаталогов). Эта команда обновляет модель последним содержимым KODA.md.

/restore [tool_call_id]¶

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

Если запустить без ID вызова инструмента, он выведет список доступных контрольных точек для восстановления.

Доступно только если CLI вызывается с опцией --checkpointing. См. документацию о контрольных точках для более подробной информации.

/settings¶

Эта команда предоставляет удобный интерфейс для изменения настроек, управляющих поведением и внешним видом Koda CLI.

Просто запустите /settings, и откроется меню.

/stats¶

Отобразить подробную статистику для текущего сеанса Koda CLI, включая использование токенов и продолжительность сеанса.

/limits¶

Показать лимиты по моделям для текущей авторизации Koda Auth. Доступна только после входа через Koda Auth.

/theme¶

Открыть диалог, который позволяет изменить визуальную тему Koda CLI.

/auth¶

Открыть диалог, который позволяет изменить метод аутентификации.

/model¶

Выберите модель, которую использует 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 для отмены.

/about¶

Показать информацию о версии. Пожалуйста, поделитесь этой информацией при подаче проблем.

/tools¶

Отобразить список инструментов, которые в настоящее время доступны в Koda CLI.

/tools desc, /tools descriptions¶

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

/tools nodesc, /tools nodescriptions¶

Скрыть описания инструментов, показывая только их названия.

/quit, /exit¶

Выйти из Koda CLI.

/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] в нижнем колонтитуле

/init**¶

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

Команды с @¶

Команды с @ используются для включения содержимого файлов или каталогов как части вашей подсказки для 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, чтобы обеспечить производительность и актуальность. Инструмент указывает, были ли файлы пропущены.

Вывод: CLI покажет сообщение вызова инструмента, указывающее, что был использован 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.