pi-subagent-manager

Hierarchical, steerable subagent threads for pi

Packages

Package details

extension

Install pi-subagent-manager from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-subagent-manager
Package
pi-subagent-manager
Version
0.29.3
Published
Oct 17, 2026
Downloads
7,500/mo · 3,712/wk
Author
championswimmer
License
MIT
Types
extension
Size
770.4 KB
Dependencies
3 dependencies · 5 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-subagent-manager

npm version npm downloads GitHub stars CI codecov

Let pi hand work to helper agents in parallel. Watch what they're doing, give them more direction, or pick up a finished agent's conversation.

Install

Requires pi 0.99.2+.

pi install npm:pi-subagent-manager

Start using it

Ask pi to delegate in plain language:

Have a reviewer check my last commit while a researcher looks up how this repo handles retries.

Or start an agent yourself:

/agents fork:coder fix the failing auth test

fork: includes your current conversation. Use fresh: instead for a task that needs no conversation history.

The Agents widget above the input shows what's running. Open /agents tree, select an agent, and press Enter to watch it. Type in the Steer input to give it more direction or resume it after it finishes. Results also return to the main agent.

Bundled agents

Agent Use it for
architect Plans, tradeoffs, coordinating helpers
coder Implementation and debugging
researcher Codebase and web research
reviewer Finding correctness and security issues
tasker Small jobs and quick lookups
writer Drafting and editing prose

They use your current model until you configure preferences. Open /agents types to change a role's model, tools, or instructions, or add your own agent.

Settings and safety

Open /agents to change delegation mode, limits, and display settings; save with Ctrl+S. Experimental options are marked [labs] in their help.

Agents share your working directory and OS permissions: tool policies are not a sandbox. Don't run multiple subagent extensions together — they clash on /agents.

Documentation

MIT license