Как подружить koda-cli с IDE по ACP и забыть про терминал — VogueTech

Что нового

Koda обновила CLI-ассистента до версии 0.3.1 и доработала поддержку ACP (Agent Client Protocol). Теперь koda-cli можно подключать к IDE как полноценного фонового ассистента, а не держать его в отдельном терминале.

Ключевые изменения:

полноценная работа по HTTP через WebSocket или JSON-RPC;
ассистент запускается один раз в фоне, а IDE выступает клиентом;
весь диалог и агентский флоу переезжают в интерфейс IDE, терминал становится не обязателен;
совместимость с уже существующими ACP-клиентами: если IDE или плагин в списке поддерживаемых клиентов ACP, его можно подключить к koda-cli.

Авторы отдельно дают ссылку на:

полное описание ACP — там расписан протокол и формат сообщений;
список клиентов с поддержкой ACP — именно они могут работать с koda-cli без костылей.

Как это работает

Архитектура у koda-cli в режиме ACP классическая клиент–серверная.

Сервер — это сам koda-cli, который вы запускаете однажды из терминала. Он поднимает HTTP‑endpoint с поддержкой WebSocket или JSON‑RPC.
Клиент — IDE или плагин с поддержкой ACP. Он подключается к локальному адресу ассистента и общается с ним по протоколу ACP.
UI и логика — живут в IDE. Все запросы, ответы, шаги агента, кнопки подтверждения — в знакомом интерфейсе редактора кода.

ACP описывает, как IDE и ассистент обмениваются сообщениями:

IDE отправляет запросы: текстовые промпты, команды «проанализируй файл», «предложи изменения» и так далее;
koda-cli отвечает структурированными сообщениями, которые клиент может отрисовать, превратить в подсказки, diff патчи, комментарии к коду;
обмен идёт поверх HTTP, а транспорт можно выбрать: WebSocket или JSON‑RPC.

Фактически IDE видит koda-cli как локальный ACP‑сервер. Никакой магии: просто ещё один сервис, к которому IDE ходит по сети, только сеть здесь — локальный компьютер.

Что это значит для вас

Главный плюс: можно пользоваться Koda как ассистентом прямо в IDE, не переключаясь в терминал и не копируя текст туда‑сюда.

Где это полезно:

Повседневная разработка. Просить ассистента дописать функции, подсказать тесты, объяснить чужой код — всё в одном окне.
Работа с большими файлами. IDE уже знает структуру проекта, а ACP‑клиент может удобнее показывать ответы, чем голый терминал.
Код‑ревью локально. Можно запускать ассистента на конкретных файлах или diff’ах прямо из редактора.

Где подход менее удобен:

если вы любите минимализм и живёте в tmux/Neovim без плагинов — тогда старый режим через терминал может оказаться проще;
если ваша IDE или редактор ещё не поддерживает ACP и нет готового плагина — придётся ждать интеграции или писать её самостоятельно.

Для старта всё равно нужен терминал: koda-cli нужно установить и запустить первый раз вручную. Дальше IDE может поднимать соединение автоматически.

Ограничения по доступности в России авторы не упоминают. Если koda-cli зависит от внешних API, часть функциональности может требовать VPN — это нужно проверять по документации Koda.

Место на рынке

Koda здесь играет в сегменте локальных ассистентов для разработчиков, которые интегрируются в IDE через открытый протокол, а не через собственный закрытый API‑плагин.

Отличительные моменты на фоне других решений:

ставка на ACP как стандартный протокол. Это значит, что один и тот же клиент в IDE может работать с разными ассистентами, поддерживающими ACP;
архитектура «один фоновый ассистент — много клиентов». Можно теоретически подключить несколько редакторов к одному koda-cli;
нет привязки к конкретной IDE: любой инструмент из списка ACP‑клиентов может стать интерфейсом для Koda.

Автор не приводит прямые сравнения по скорости, цене токена или размеру контекста с GPT-4o, Claude 3.5 и другими ассистентами. Фокус именно на интеграции через ACP и отказе от терминала как основного интерфейса.

Установка

Для первой настройки koda-cli терминал всё же понадобится. Авторы предлагают начать именно с «чистой» установки ассистента.

Если вы раньше не пользовались koda-cli, сейчас как раз подходящий момент:

Откройте терминал.
Установите koda-cli по инструкции из официальной документации Koda (конкретные команды зависят от вашей ОС и менеджера пакетов).
Убедитесь, что команда koda-cli запускается и ассистент отвечает в терминале.

После этого можно переходить к интеграции с IDE через ACP.

Как запустить с IDE через ACP

Дальнейшие шаги зависят от вашей IDE, но общая логика такая:

Запустите koda-cli как ACP‑сервер.

В терминале нужно стартовать ассистента с поддержкой ACP. Конкретная команда зависит от настроек Koda и может выглядеть примерно так (примерный формат, ориентируйтесь на документацию):
```
koda-cli acp --host 127.0.0.1 --port 8000
```
Ассистент начнёт слушать HTTP‑подключения по адресу http://127.0.0.1:8000.
Настройте ACP‑клиент в IDE.
- откройте настройки плагина или встроенного клиента ACP;
- укажите адрес локального сервера koda-cli (host, port, протокол — WebSocket или JSON‑RPC);
- сохраните конфигурацию и перезапустите IDE, если это требуется.
Проверьте соединение.
- отправьте тестовый запрос ассистенту из IDE (обычно есть кнопка «Test connection» или простое окно чата);
- убедитесь, что ответы появляются в интерфейсе IDE, а не в терминале.

Полный список IDE и клиентов, которые уже умеют ACP, авторы дают отдельной ссылкой. Если ваш любимый редактор есть в этом списке — его можно сразу подключать к koda-cli.

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