pi-better-subagents
v0.1.17
Published
Pi extension for detached, sandboxed subagent runs that keep the foreground session free.
Downloads
2,460
Maintainers
Readme
pi-better-subagents
pi-better-subagents is a Pi extension for detached, sandboxed subagent runs that keep the foreground Pi session free.
Quick Answer
Use pi-better-subagents when you want Pi to launch independent agent work without blocking the current conversation. Each subagent runs in its own pi -p child process, reports back when finished, and keeps durable logs for later inspection.
Screenshots
Core Features
- Non-blocking subagent launches.
- Default OS write sandboxing on macOS and Linux.
- Explicit tool allowlists for child sessions.
- Durable logs and result retrieval across reloads.
- Live background-work navigator for active runs.
Install
pi install npm:pi-better-subagentsTry it for one run:
pi -e npm:pi-better-subagentsLinux sandboxing uses bubblewrap when available, for example from sudo apt-get install bubblewrap.
When To Use
Use this package for independent coding, review, research, or verification work that can finish later. Do not use it for steps that need immediate foreground interaction or user clarification.
Compatibility
| Requirement | Support |
|-------------|---------|
| Pi | Required |
| Install method | pi install npm:pi-better-subagents |
| macOS sandboxing | Supported by default |
| Linux sandboxing | Uses bubblewrap when available |
| Development runtime | Node.js 22+ |
Update Or Remove
pi update npm:pi-better-subagents
pi remove npm:pi-better-subagentsMore Detail
- Repository: https://github.com/1aboveio/pi-better-harness
- Detailed notes: https://github.com/1aboveio/pi-better-harness/blob/main/packages/pi-better-subagents/docs/usage.md
- License: https://github.com/1aboveio/pi-better-harness/blob/main/LICENSE
