Skip to main content

Veai CLI в Orca

Orca — десктопное приложение, в котором несколько AI-агентов работают параллельно, каждый в своём git worktree и своём терминале. Veai CLI построен на базе Pi, а Pi Orca поддерживает из коробки. Поэтому Veai CLI подключается в Orca заменой команды запуска Pi.

Работает и без настройки​

Veai CLI — обычная терминальная программа, а Orca запускает в терминале любой CLI-агент. Откройте в Orca терминал в нужном worktree и выполните veai: агент заработает как в любом другом терминале.

Настройка ниже нужна, чтобы Orca запускала veai сама и лучше понимала, что делает агент:

  • статус агента — Orca показывает, работает агент, ждёт вас или закончил, и присылает уведомления;
  • спиннер во вкладке — по заголовку вкладки видно, что агент занят;
  • предзаполнение промпта — промпт, который вы задали при создании задачи в Orca, попадает в поле ввода агента.

Как настроить​

  1. Откройте настройки Orca и перейдите в раздел Agents.

  2. Найдите в списке установленных агентов Pi.

  3. В поле Command вместо pi введите veai.

  4. В поле Arguments укажите расширения Orca для Pi, каждое с флагом --extension:

    --extension <HOME>\.pi\agent\extensions\orca-agent-status.ts --extension <HOME>\.pi\agent\extensions\orca-titlebar-spinner.ts --extension <HOME>\.pi\agent\extensions\orca-prefill.ts

    Вместо <HOME> подставьте домашний каталог своего пользователя:

    ОСКак выглядит путь
    WindowsC:\Users\<имя пользователя>\.pi\agent\extensions\orca-agent-status.ts
    macOS/Users/<имя пользователя>/.pi/agent/extensions/orca-agent-status.ts
    Linux/home/<имя пользователя>/.pi/agent/extensions/orca-agent-status.ts

    Если вы задали переменную PI_CODING_AGENT_DIR, ищите файлы в $PI_CODING_AGENT_DIR/extensions.

  5. Запустите Pi из Orca обычным способом, например через меню запуска агентов в новом worktree. Вместо Pi откроется Veai CLI.

Файлы orca-agent-status.ts, orca-titlebar-spinner.ts и orca-prefill.ts — расширения Orca для Pi. Orca сама устанавливает их для Pi (автонастройка) в папку extensions агента Pi. Veai CLI эту папку не читает, поэтому подключать файлы нужно явно флагами --extension.

Проверка​

Создайте в Orca worktree и запустите Pi. Должен открыться Veai CLI. Дайте ему задачу: во вкладке появится спиннер, а в списке worktree — статус агента.

Veai CLI в Orca: спиннер у worktree и строка агента Pi в списке

Если Veai CLI запускается, но статусов нет, проверьте, что пути в Arguments указывают на существующие файлы и в них нет опечаток.