JetBrains, Zed и редакторы с ACP

Запускайте Cusp командой `cusp acp` в любом редакторе, который поддерживает Agent Client Protocol, — в IDE JetBrains, Zed, Kiro и других.

cusp acp запускает Cusp как агента Agent Client Protocol (ACP) через стандартный ввод и вывод. Редакторы, которые умеют работать с ACP-агентами, управляют через него сессиями Cusp без всякого плагина.

Каждая сессия, которую запускает редактор, — обычная сессия Cusp. Она появляется в десктопном приложении и в cusp --resume, и продолжить её можно в любом из них.

Перед началом

CLI cusp установлен. Полный путь к нему покажет which cusp (macOS, Linux) или where cusp (Windows). Редакторы запускают агентов без профиля вашей оболочки, поэтому указывайте абсолютный путь.
В Cusp настроен провайдер моделей (десктопное приложение → Настройки → Провайдеры) или ключ провайдера есть в переменных окружения, например ANTHROPIC_API_KEY.
Больше ничего не нужно. cusp acp использует работающий демон (daemon), например демон десктопного приложения, или запускает свой для редактора.

Настройка редактора

AI Assistant в IntelliJ IDEA, WebStorm, PyCharm, GoLand, Rider и других IDE JetBrains подключает собственные ACP-агенты из ~/.jetbrains/acp.json.

Откройте окно инструментов AI Chat, откройте меню агентов в его правом верхнем углу и выберите Add Custom Agent. Будет создан и открыт файл ~/.jetbrains/acp.json.

Добавьте Cusp в agent_servers. Ключ — это имя, которое отображается в AI Chat:

~/.jetbrains/acp.json

{
  "default_mcp_settings": {},
  "agent_servers": {
    "Cusp": {
      "command": "/Users/you/.local/bin/cusp",
      "args": ["acp"],
      "env": {}
    }
  }
}

Выберите Cusp в списке агентов AI Chat и отправьте запрос.

Примечания:

Оставьте default_mcp_settings пустым. Cusp использует свою конфигурацию MCP и игнорирует серверы, которые предлагает IDE.
Открытый файл, выделение и диагностику JetBrains добавляет автоматически только для встроенных агентов. С Cusp прикрепляйте то, что агент должен увидеть. Прикреплённые файлы читаются через IDE, поэтому несохранённые изменения тоже попадают в контекст.
Ключи в env хранятся открытым текстом. Лучше настройте провайдеров в Cusp: он хранит ключи в системной связке ключей (Keychain).
JetBrains не поддерживает ACP-агентов в WSL.

Если Cusp не запускается

Выполните команду сами в терминале:

/full/path/to/cusp acp --verbose

Она должна молча ждать ввода и писать диагностику в стандартный поток ошибок. Если команда завершилась, в сообщении будет причина. Проверьте путь и JSON, затем перезапустите редактор.

Параметры

cusp acp [--permission-mode <mode>] [-m <provider:model>] [--effort <level>]
         [--daemon-url <url> --daemon-token <token>] [--data-dir <dir>] [--verbose]

Параметр	Назначение
`--permission-mode`	Режим разрешений по умолчанию для новых сессий
`-m`, `--effort`	Модель и уровень рассуждений по умолчанию для новых сессий
`--daemon-url`, `--daemon-token`	Подключиться к конкретному демону
`--data-dir`	Папка данных для демона, который запускает `cusp acp`
`--verbose`	Писать журнал в стандартный поток ошибок. В стандартный вывод идут только сообщения протокола

Редактор всё равно может менять режим, модель и уровень рассуждений для каждой сессии.

Что работает

В редакторе	В Cusp
Создание, загрузка, возобновление, список и закрытие сессий	Сессии демона. При загрузке переписка воспроизводится заново; список фильтруется по папке
Запросы	Текст, изображения, встроенные ресурсы и ссылки на файлы. Связанные файлы читаются через редактор, поэтому несохранённые буферы тоже видны
Потоковый вывод	Текст ответа и размышлений, вызовы инструментов с расположением в файлах, диффы правок, планы-списки задач, обновления режима, заголовка и заполненности контекста
Запросы разрешений	Allow once, Always allow или Deny. Вопросы с вариантами ответа предлагаются как выбор
Отмена	Прерывает ход и отзывает открытые подтверждения
Режимы и параметры	Ask, Accept edits, Plan, Auto, Don't ask и Bypass, а также выбор модели и уровня рассуждений
Слеш-команды	`/compact [focus]`

Пока не поддерживается

MCP-серверы, переданные редактором, игнорируются. Настраивайте MCP-серверы в Cusp.
Запись файлов через редактор не используется. Cusp записывает файлы сам и создаёт контрольные точки, к которым можно откатиться.
Запуск команд в терминале редактора не используется. Команды выполняются в оболочке Cusp, а вывод передаётся обратно потоком.
Голосовой ввод не поддерживается.
Методы аутентификации не нужны: Cusp использует конфигурацию локального демона.

Дальше

VS Code: отдельное расширение.
Справочник CLI: все команды и флаги cusp.

JetBrains, Zed и редакторы с ACP

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

Настройка редактораСкопировать ссылку на раздел

Если Cusp не запускаетсяСкопировать ссылку на раздел

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

Что работаетСкопировать ссылку на раздел

Пока не поддерживаетсяСкопировать ссылку на раздел

ДальшеСкопировать ссылку на раздел