Pi Herdr Subagents — Development skill for Claude Code
Interactive subagents for pi running in herdr.
How to install Pi Herdr Subagents
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open aliceisjustplaying/pi-herdr-subagents and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Pi Herdr Subagents does
Interactive subagents for pi running in herdr.
Alternatives in Development
- Understand Anything — Graphs that teach graphs that impress 80.7k ★
- Clean Worktree (Interactive) — Interactive cleanup of worktrees: lists merged/stale branches and asks confirmation before deleting 25.5k ★
- Claudia — A powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions 21k ★
README
pi-herdr-subagents
Async subagents for [pi](https://github.com/badlogic/pi-mono) running exclusively in [herdr](https://herdr.dev). Spawn, orchestrate, and manage recursive sub-agent sessions in dedicated herdr tabs or panes. **Fully non-blocking** — the main agent keeps working while subagents run in the background. Pi-backed OpenAI and OpenAI-Codex children use the standard service tier by default and can opt into priority processing per dispatch with `fast: true`.
How It Works
Call `subagent()` and it **returns immediately**. The sub-agent runs in its own terminal pane. A live widget above the input shows all tracked agents with their projected state — for example `starting`, `active`, `waiting`, `interrupted`, `stalled`, `running`, or `finalizing`. The header summarizes **active** (processing) vs **open** (not processing). When every tracked subagent is open, the border switches to amber. When a sub-agent finishes, its result is **steered back** into the main session as an async notification — triggering a new turn so the agent can process it.
╭─ Subagents ──────────────────── 1 active · 1 open ─╮
│ 00:23 Map auth active · bash 7m │
│ 00:45 Map DB schema waiting 2m │
╰────────────────────────────────────────────────────╯
For parallel execution, just call `subagent` multiple times — they all run concurrently:
subagent({ name: "Map auth", task: "Analyze the auth module and report its entry points" });
subagent({ name: "Map DB schema", task: "Map the database schema and its migrations" });
// Both return immediately, results steer back independently
Development
Run unit tests and lint locally:
npm test
npm run lint
Run the real end-to-end suite from inside herdr with an explicit test model:
PI_TEST_MODEL="deepseek/deepseek-v4-flash" PI_TEST_TIMEOUT=180000 npm run test:integration
The full suite launches real Pi sessions and can take several minutes. `PI_TEST
Related Skills
Herdr Game
Interactive game for learning Herdr shortcuts, workflows, and agent operations
Herdr Reviewr
Review your coding agent's diff in a terminal pane and send line comments back to Claude Code, Codex, OpenCode
Herdrm
Native macOS console for herdr — all your coding agents and their live terminals, across devices
Pairfob
Your Herdr agents on your phone in one QR scan. No Tailscale or ports, no app or account, end-to-end encrypted
Herdr Lantern
Lantern, by Elves. A Herdr plugin: the herd is in the field; Lantern illuminates who needs you and what they a
Herdr Auto Title
Automatically generate titles for herdr tabs from Claude Code and Codex conversations.
Related Agents
Plugin Dev
Scoped guide for work on the herdr-plugin-pipeline plugin itself — the hpipe CLI, the supervisor, the phase ma
Transport Verifier
Runs live end-to-end checks of a delivery transport (Herdr socket, MCP server, Claude Code or Codex hook, Open
Herdr Worker
Worker agent for herdr orchestrated tasks. Executes a specific subtask within strict file boundaries, reports