Перейти к содержанию

Добро пожаловать в Koda CLI

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

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

Быстрый старт

npx -y @kodadev/koda-cli

Минимальные требования: Node.js 20 или новее, npm, macOS, Linux или Windows. Для контрольных точек нужен Git, для контейнерной песочницы — Docker или Podman.

Перейдите на страницу быстрого старта для дополнительной информации.

Возможности

  • Интерактивный чат и агент

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

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

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

    Подробнее

  • Работа с файлами

    Чтение, поиск, массовая загрузка контекста и diff-based редактирование.

    Перед применением правок CLI показывает diff, чтобы вы могли проверить изменения.

  • Субагенты

    Для объёмных исследований агент запускает фоновых субагентов: они работают параллельно в изолированном read-only контексте, а готовый результат приходит в основной диалог. Готовые роли субагентов можно запускать меткой @agent:<имя> в начале сообщения.

    Подробнее

  • Shell и автоматизация

    Запуск тестов, линтеров и других shell-команд с подтверждением.

    Неинтерактивный режим koda -p подходит для сценариев CI/CD.

    Подробнее

  • Model Context Protocol MCP и расширения

    Подключение MCP-серверов (stdio, SSE, HTTP), навыков и расширений для дополнительных возможностей.

    Подробнее

  • Память проекта

    Проектная память хранится в KODA.md или AGENTS.md, глобальная — в ~/.kodacli/KODA.md.

    Файлы памяти подключаются автоматически и задают контекст для каждой сессии.

    Подробнее

  • Интеграция с IDE

    Контекст из совместимых IDE: открытые файлы, курсор, выделение, diff в редакторе.

    Подробнее

Базовые сценарии

koda
koda -p "Объясни архитектуру проекта"
koda -i "Найди потенциальные проблемы и продолжи сессию интерактивно"
koda --include-directories ../shared,../docs
koda --model koda-base
  • -p подходит для CI и shell-скриптов: prompt выполняется один раз, stdin добавляется к prompt, затем процесс завершается.
  • -i сначала выполняет prompt, а потом оставляет интерактивную сессию открытой.
  • --include-directories добавляет дополнительные каталоги в рабочую область.
  • --model выбирает модель для сессии.

Режимы запуска

Режим Команда Что делает
Интерактивный koda открывает TUI и ведёт диалог с моделью
Неинтерактивный koda -p "запрос" выполняет запрос и завершает процесс
Гибридный koda -i "запрос" выполняет запрос и оставляет сессию открытой