Pi Herdsman — плагин
Расширение Pi для фоновых субагентов: делегирует задачи параллельно, строит цепочку Manager, Lead и Agent и следит за ней в herdr
- 226 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Запускает фоновых агентов, которые параллельно меняют файлы и ветки Git без постоянного участия человека
- Вложенное делегирование дает агентам право поручать задачи другим агентам, поэтому действия трудно охватить одним взглядом
- Сообщения между машинами идут по SSH, а установщик запускается через curl и sh
Установка
Ручная установка
curl -fsSL https://raw.githubusercontent.com/boadij/pi-herdsman/main/install.sh | shСкрипт для Linux и macOS, на Windows есть install.ps1. Перед запуском прочтите скрипт.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Запускает фоновых агентов, которые параллельно меняют файлы и ветки Git без постоянного участия человека
- Вложенное делегирование дает агентам право поручать задачи другим агентам, поэтому действия трудно охватить одним взглядом
- Сообщения между машинами идут по SSH, а установщик запускается через curl и sh
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Pi Herdsman связывает агента Pi с терминальным мультиплексором herdr. Pi ведет диалог, herdr хранит терминальные сессии и рабочие пространства, а Herdsman распределяет задачи и следит за исполнением. Обычная сессия Pi становится Lead и отдает ограниченные задачи фоновым Agents, не блокируя разговор. Результат возвращается в ту беседу, которая задачу выдала. На уровне проекта сессия Lead переходит в режим Manager и координирует несколько независимых Leads. Работа привязана к веткам Git, поэтому ее можно приостановить, продолжить или передать другому Manager. Необязательный Chief стоит над Manager и надзирает за ними. Agents, у которых включено вложенное делегирование, поручают свои подзадачи дальше по цепочке. Leads обмениваются сообщениями между собой, а между машинами письма идут по SSH. Расход токенов и стоимость видны для текущей сессии и всех управляемых ею Agents. Определения Agents, модели, инструменты, скиллы и расширения остаются вашими. Команда /herdsman внутри Pi показывает доступные возможности.
Для кого. Пользователям Pi и herdr, которые хотят гонять несколько кодинг-агентов параллельно и держать их под контролем из одной сессии.
Подходит, если
- Разведка по репозиторию занимает время, и агент scout должен изучать точки входа, пока вы продолжаете беседу
- Задача делится на независимые ветки Git, и каждой нужен свой Lead с деревом помощников
- Агент сам должен раздавать подзадачи, а вы хотите видеть, сколько токенов и денег ушло на каждую ветку
- Над проектом работают сессии Pi на разных машинах, и им нужен обмен сообщениями по SSH
- У вас готовые определения агентов, модели и скиллы, которые надо подключить без смены рабочего процесса
Не подходит, если
- Вы работаете в Claude Code или Codex: расширение написано только под Pi и herdr
- Нужен один агент в одном окне: слой координации ничего не добавит
- Нужна стабильность 1.0: до первой версии конфигурация и соглашения могут меняться
- Машины связаны без SSH: для обнаружения и первого сообщения между ними нужен SSH-маршрут
Пример запроса к агенту
Пусть scout изучит точки входа этого репозитория и объяснит, как запускается приложение. Файлы не меняйОграничения
- Проект на раннем этапе: релизы до 1.0 могут ломать конфигурацию, миграции описаны в журнале изменений.
- Chief еще разрабатывается: развертывание репозиториев и управление жизненным циклом Manager пока не готовы.
- Обнаружение и первое сообщение между машинами требуют SSH-маршрута от инициатора, ответы идут по уже открытой переписке без обратного SSH.
- Нужны Pi и herdr, а модели берутся из настроенной аутентификации Pi.
Как отключить. Удалите пакет pi-herdsman из расширений Pi и отключите интеграцию herdr с Pi. Точные команды зависят от версий Pi и herdr, их описывает документация этих проектов.
Частые вопросы
Чем отличаются Lead, Manager и Chief?
Lead — обычная сессия Pi, она владеет делегированными Agents. Manager координирует нескольких Leads по веткам Git и сам через Agents не реализует задачи. Chief — необязательный надзиратель над Managers.
Как поставить Pi Herdsman?
Если Pi и herdr уже есть, выполните pi install npm:pi-herdsman и herdr integration install pi. Для чистой машины в репозитории есть установочные скрипты для Linux, macOS и Windows.
Можно ли запускать Agents внутри Agents?
Да, если вложенное делегирование включено для конкретного Agent. Тогда он поручает собственные ограниченные подзадачи, а владение остается цепочкой Lead, Agent, Agent.
Как узнать, сколько стоит работа Agents?
Расширение показывает расход токенов и стоимость по данным Pi для текущей сессии и всех управляемых ею Agents. Активный Manager видит и Leads из текущих назначений проекта.
На каких системах работает Pi Herdsman?
На Linux, macOS и Windows: на этих трех системах репозиторий проверяет сборку в CI. Для Linux и macOS есть установочный скрипт на sh, для Windows на PowerShell.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПакет для агента Pi: фоновые субагенты работают параллельно в панелях Herdr, результаты возвращаются сами.
Панель herdr рисует рой агентов живым графом: попытки, ворота проверки и доказательства, чтобы не терять нить в больших прогонах.
Расширение для агента Pi: один программируемый инструмент fabric_exec вызывает инструменты, MCP, агентов и воркфлоу кодом
Фоновый запуск кодовых агентов pi у вас на машине по расписанию и меткам: каждое задание в контейнере Docker и с лимитом трат.
Личная конфигурация агента Pi с четырьмя командами: план, задачи, исполнение и ревью через файлы сессии в Markdown.
pi-intercom связывает сеансы pi на одной машине: сообщения один на один между агентами или по горячей клавише Alt+M.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Pi Herdsman (эта карточка) | нет | 226 | |
| pi-subagents | нет | 1 449 | субагенты и оркестрация в стиле Claude Code для Pi, без ролей Manager и Chief и надзора по веткам |
| herdr | нет | 50 721 | сам терминальный мультиплексор для агентов, а Herdsman добавляет к нему делегирование внутри Pi |
Коротко о README
Страница начинается с описания связки Pi и herdr и демонстрации цепочки Manager, Lead, Agent. Затем даны быстрый старт, схема ролей, таблица статуса компонентов и перечень ближайших работ. Внизу собраны ссылки на документацию по запуску, проектной оркестрации, переписке между сессиями и пользовательским определениям Agents.