Skip to main content

Veai CLI в herdr

herdr — терминальный мультиплексор для AI-агентов: рабочие пространства (workspaces), вкладки (tabs) и панели (panes), в каждой из которых работает свой агент. Агенты продолжают работу, даже если вы закрыли окно. Veai CLI построен на базе Pi, а Pi herdr поддерживает, поэтому Veai CLI в нём работает.

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

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

Интеграция ниже даёт больше: herdr начинает получать состояние агента от него самого, а не угадывает его по тому, что нарисовано на экране. Это даёт точные статусы idle, working и blocked в боковой панели Agent, корректные уведомления и ожидание завершения агента из скриптов и других агентов.

Как подключить интеграцию​

  1. Установите интеграцию Pi командой herdr:

    herdr integration install pi

    herdr запишет расширение в ~/.pi/agent/extensions/herdr-agent-state.ts. На Windows ~ — это ваш домашний каталог, например C:\Users\<имя пользователя>. Если задана переменная PI_CODING_AGENT_DIR, файл появится в $PI_CODING_AGENT_DIR/extensions. Каталог создаётся, только если папка агента Pi уже существует.

  2. Проверьте, что файл расширения появился. Veai CLI сам не читает папку ~/.pi/agent/extensions, поэтому расширение нужно подключать флагом --extension:

    veai --extension ~/.pi/agent/extensions/herdr-agent-state.ts

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

  3. Откройте файл настроек своей оболочки и добавьте в конец строку с коротким именем команды.

    bash — файл ~/.bashrc:

    alias veai-herdr='veai --extension "$HOME/.pi/agent/extensions/herdr-agent-state.ts"'

    zsh (по умолчанию в macOS) — файл ~/.zshrc, строка та же:

    alias veai-herdr='veai --extension "$HOME/.pi/agent/extensions/herdr-agent-state.ts"'

    PowerShell (Windows) — профиль, который открывается командой notepad $PROFILE. Если файла нет, сначала создайте его командой New-Item -ItemType File -Force $PROFILE. В PowerShell алиас не принимает аргументы, поэтому вместо него добавьте функцию:

    function veai-herdr { veai --extension "$HOME\.pi\agent\extensions\herdr-agent-state.ts" @args }

    Если у вас задана переменная PI_CODING_AGENT_DIR, замените в пути $HOME/.pi/agent на её значение.

  4. Примените изменения: откройте новую панель в herdr или выполните в текущей source ~/.bashrc (в zsh — source ~/.zshrc, в PowerShell — . $PROFILE).

  5. В панели herdr запускайте агента командой veai-herdr вместо veai. Любые аргументы veai, например --continue, можно дописывать после неё.

Проверка​

Запустите veai в панели и дайте агенту задачу. Пока он работает, в боковой панели herdr у панели будет статус working, а когда агент закончит, idle. Что именно herdr определил для панели, показывает команда herdr agent explain <панель>.