Pi Herdr Agents plugin
A package for the Pi agent: async subagents run in parallel in Herdr panes and results return on their own.
- 72 ★ on the repository
- Last commit
Broad access
Why this level
- Child agents run as real processes with your user account permissions.
- Writing agents alter git worktrees, and isolation covers only the repository.
Install
Manual install
pi install npm:pi-herdr-agentsThe command installs the package into Pi. It runs inside Herdr: start `herdr` first, then `pi`. For Core run `pi` in a local Core terminal.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Child agents run as real processes with your user account permissions.
- Writing agents alter git worktrees, and isolation covers only the repository.
This is third-party code. Review the repository files before installing.
What it does
Pi Herdr Agents adds subagents to Pi that do not block the parent session. Each child runs as a real Pi process in a Herdr pane or in a local Herdr Core terminal. The main session keeps working and the result arrives on its own when the child finishes an investigation, edit or review. The tools let you launch scouts, workers and reviewers at once, interrupt one turn without ending the session, and resume or cancel children. In ordinary Herdr mode writing agents get managed git worktrees, and the `/worktree` command moves the conversation into a new tree. The operating guide loads with `/skill:pi-herdr-agents`.
Who it is for. People working in Pi inside Herdr who want to parallelize research, edits and review without blocking the main conversation.
Good fit when
- You need to launch three scouts on different modules and continue the conversation.
- A worker gets its own git worktree for a long edit.
- An independent reviewer reviews changes without waiting for the main agent.
- A persistent specialist keeps one session for sequential tasks.
Not a fit when
- The agent is not Pi, since the package is made only for it.
- Herdr is not available, because other terminal multiplexers are not supported.
- You need ready-made roles and workflows, which the package does not ship.
Example request
Launch two scouts in parallel: one studies the auth module, the other the tests. While they work, keep talking with me about the plan.Limitations
The package works only in Pi inside Herdr: either legacy Herdr with the `herdr` command line and `HERDR_ENV=1`, or a local Herdr Core terminal. Core supports ordinary child launches while managed worktrees are not available yet. Windows support is experimental: worktrees and Core are refused there before any action. Worktrees isolate only git, not processes or permissions: child agents and Pi packages run with your user account access. No roles or workflows ship by default.
How to disable. Remove the package with Pi tooling, restart Pi and close leftover Herdr panes. Delete `git worktree` trees by hand.
FAQ
How do I install the package?
With `pi install npm:pi-herdr-agents`. Add `-l` to install into the project only, or use `pi -e npm:pi-herdr-agents` for a single run.
Does a subagent block the main session?
No. The `subagent` tool acknowledges the launch and returns control at once, processes run asynchronously and the result arrives on its own.
What is a persistent specialist?
A single policy-bound Pi session kept for sequential turns, for example a reviewer receiving tasks in turn.
Are ready roles included?
No, the package is neutral. Roles come from the project, global definitions or a role pack. A separate `pi-herdr-clean-craft` package adds six methodology skills.
How limited is isolation?
Worktrees separate only git checkouts. Processes and permissions are shared, so review Pi packages before installing.
Discussion
No questions or reviews yet.
Related
PluginsPi extension for background subagents: parallel delegation, a Manager, Lead and Agent chain and supervision in herdr
A herdr pane that draws an agent swarm as a live graph with attempts, review gates and evidence, so large runs stay readable.
An extension for the Pi agent (pi.dev): subagents and orchestration in the Claude Code style, a widget and JavaScript scripts. Not for Claude Code
A Herdr plugin that gives every coding agent its own Telegram topic, with status in the icon and messages both ways.
An extension for the Pi agent: one programmable fabric_exec tool calls tools, MCP, agents and workflows from code
Background runs of pi coding agents on your machine by schedule and label, each job in a Docker container with a spending limit.
README in short
The repository publishes an npm package and an agent guide at `skills/pi-herdr-agents/SKILL.md`. It also bundles an optional Herdr sidebar plugin and skills under `.pi/skills/` for developing the project itself. The base Herdr mode is unchanged and Core mode is selected automatically from its own environment.