Pi Subagents
Extension
Adds controlled subagent delegation, scripted multi-agent workflows, background execution, and recovery surfaces to Pi.
What it does
Pi Subagents adds controlled delegation, scripted multi-agent workflows, background execution, and recovery surfaces to Pi.
Child model, tools, context, and execution settings resolve from parent overrides plus agent or package defaults.
When to reach for it
Invocation: Ask the model to use the subagent tool or invoke one of the package's operator commands.
- Independent research or review lanes can run in parallel
- Launch bounded children and aggregate their outputs.
- One parent should retain decisions while another agent implements or reviews
- Delegate the narrow role and keep final authority in the parent session.
- Long work should continue without blocking the interactive session
- Run the child in the background and recover through persisted status.
What it adds
- One model-invoked delegation tool with sequential and parallel workflow controls.
- Background lifecycle, wait, recovery, and operator-facing command surfaces.
How it fits
- Handoff: Subagents divide work inside an orchestration; handoff moves selected context to a fresh top-level session.
- Visual Explainer: Visual Explainer can recommend a subagent context-gathering pass before rendering.
- Pi Ralph Loop: Ralph governs durable task iterations; subagents provide bounded execution and review lanes within them.
Common questions
- What are the operating costs?
- Each child consumes model time and may receive narrower context or tools; this setup reviews the installed revision, not current upstream main.
It’s working if
- The parent receives a completed child result or a recoverable background status.
- Child tools and context match the resolved launch contract.
Source and setup
Provenance
- Project
- Pi Subagents
- Origin
- Nico Bailon
- Current maintainer
- Nico Bailon
- Relationship
- original
- Installed source
git:github.com/nicobailon/pi-subagents- Source path
- View source (
index.ts) - Compatibility
- Pi package APIs
- Child model and tool configuration
- License
- MIT
- License publication scope
- Source link, independently written summary, attribution, and reviewed behavior claims.
- Reviewed revision
b6161f661723a6c223d1bf46e4d883f703b44aca- Catalog revision
e0c035a297462c519315abfa1af31a1ed3bd9eef
Setup notes
- Created and maintained by Nico Bailon; installed directly from the original MIT-licensed project.
- The package is installed from its Git repository and depends on Pi package APIs plus child model and tool configuration.
- Behavior claims were reviewed against the installed revision rather than a moving branch.