aliceisjustplaying

Pi Herdr Subagents — Development skill for Claude Code

Development community

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