Pi Subagents
github.com/nicobailon/pi-subagents- Category
- AI Agents
- Rank
- No. 854Tools index
Previous survey · No. 837 ·
- Type
- APP
- Builder
- nicobailon
- GitHub
- 3.6k stars
- Latest release
- v0.68.0
- Date
About
A Pi extension for async subagent delegation with truncation, artifacts, and sessions.
What it does
Pi Subagents lets a parent Pi session hand focused jobs to child sessions. Users request scouting, research, implementation, review, or second opinions in plain language. Work can stream into the current conversation or continue in the background, while a fleet inspector exposes progress, transcripts, steering, and stop controls.
Why it's ranked here
The tool combines an approachable starting point with unusually deep operational control. Six ready-to-use roles cover common engineering work, while parallel runs, review loops, saved workflows, schedules, acceptance gates, and visible run state support more demanding use. The extensive configuration surface also means its greatest value appears after teams define repeatable delegation rules.
What's good
The built-in roles express clear boundaries: scouting finds code paths, workers edit and validate, reviewers check changes, and the oracle challenges decisions without editing. Foreground streaming keeps short jobs conversational. Background visibility includes active state, transcripts, steering, stopping, events, logs, and machine-readable artifacts. Preflight checks resolve agents, skills, models, tools, permissions, and output locations before execution.
Tradeoffs
This is specifically an extension for Pi, with Pi packages declared as peer dependencies. Installing it only adds delegation capability; automatic review requires explicit prompts or project instructions. Advanced use spans agents, models, permissions, workflows, missions, observability, watchdog behavior, and extension APIs, so adopting the full system carries meaningful configuration and operating complexity.
How to use it well
It suits engineers already working in Pi who want repeatable separation between reconnaissance, implementation, review, and decision checking. Start with the packaged roles, then encode an implementation loop that scouts first and uses fresh reviewers after edits. Use background runs for independent work and the fleet inspector for supervision. It does not replace the parent coding environment or create automatic review policy by installation alone.
Technical notes+
package.json defines an ESM TypeScript npm package, a pi-subagents binary, Pi extension registration, bundled skills and prompts, optional Pi peer dependencies, and separate unit, integration, and end-to-end test scripts. index.ts re-exports the extension entry. src/api/preflight.ts builds a hashed launch contract after resolving agent scope, skills, model candidates, capability ceilings, tools, artifacts, and diagnostics. src/tui/fleet.ts aggregates foreground and asynchronous runs, orders active work before recent history, and supports steering, inspection, and stopping. src/shared/utf8.ts truncates output by byte count without returning a tail that starts inside a UTF-8 continuation sequence.
Observed
- License
- MIT
- Primary language
- TypeScript
- Packaging
- ESM npm package named pi-subagents, installable through Pi's npm package installer
- Interfaces
- Pi extension, pi-subagents CLI binary, and exported TypeScript API modules
- Bundled surface
- Includes built-in agents, skills, prompts, and documentation in the published package
- Test structure
- Package scripts define unit, integration, end-to-end, and combined test runs
Read from README.md, package.json, index.ts, src/tui/fleet.ts, src/tui/render.ts, src/api/pi-args.ts, src/shared/utf8.ts, src/shared/types.ts, src/shared/utils.ts, src/agents/agents.ts, src/agents/skills.ts, src/api/preflight.ts.
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.