Добавление собственного CLI-агента

Чтобы подключить к Orca любой консольный агент, достаточно указать его команду запуска и аргументы.

Добавление произвольного CLI-агента: укажите исполняемый файл, и агент появится в списке

Добавление агента

Откройте Настройки → Агенты.
Нажмите Добавить собственного агента.
Укажите название, путь к исполняемому файлу или команду и аргументы по умолчанию.
При необходимости добавьте хук запуска: команду оболочки, которую Orca выполнит перед запуском агента, например source .envrc.

Что будет доступно

Агент появится в списке каждого терминала.
Рабочим каталогом всегда будет текущий worktree.
После завершения процесса появится кнопка перезапуска.
Если CLI отправляет заголовки OSC, Orca будет показывать индикатор состояния.

Настройка индикатора состояния

Orca определяет состояния "работает" и "ожидает" по обновлениям заголовка OSC. Если агент отправляет заголовки наподобие working или idle, Orca распознает их автоматически. Если таких событий нет, терминал продолжит работать как обычно, но без индикатора состояния.

Через список агентов можно запускать и обычные bash или zsh. Такая оболочка сразу открывается в каталоге текущего worktree.

Частые вопросы

Можно ли добавить в Orca свой CLI-агент?

Да. В настройках агентов можно создать собственную запись и указать команду запуска.

Какие параметры нужны для пользовательского агента?

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

Должна ли команда агента быть доступна в PATH?

Да. Orca должна находить исполняемый файл в своём окружении либо получить полный путь к нему.

Обязательна ли поддержка специальных индикаторов состояния?

Нет. Агент можно запускать и без них, но интеграция со статусами делает состояние сессии понятнее.

Где будет рабочая папка пользовательского агента?

Orca запускает его в текущем worktree, если сама команда не меняет рабочую директорию.