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-subagents

Try it for one run:

pi -e npm:pi-better-subagents

Linux 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-subagents

More 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