$ cat ~/map/pi-subagents-williamcr01.md

pi-subagents (williamcr01)

Recursive, isolated background subagents with a live status tree — zero external npm dependencies.

extensions✓ Sep 4

pi install npm:@williamcr01/pi-subagents

## TL;DR

A pi extension adding recursive, isolated background subagents: spawn_agent returns immediately, children run in their own pi process and session, and a live footer tree tracks every run with fully inspectable transcripts.

## Key points

• $spawn_agent starts a child immediately in its own Pi process and session; check_subagents inspects progress or waits for results (wait: true with timeoutMs).
• $send_to_subagent steers a running child or continues a finished one; cancel_subagent stops it — both accept a run ID, session ID, or exact name.
• $Recursive delegation is bounded by a configured depth budget, and concurrency is configurable including unlimited mode with maxConcurrency: -1.
• $In TUI mode, press Down at the bottom of the editor for the live subagent panel; /subagents reviews finished agents and transcripts.
• $Restart Pi or run /reload after installing; the scoped npm name @williamcr01/pi-subagents is distinct from nicobailon's unscoped pi-subagents package.

## FAQ

## References

• README ↗

Last updated: Sep 4, 2026