pi-better-subagents

Pi extension for detached, sandboxed subagent runs that keep the foreground session free.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-better-subagents
Package
pi-better-subagents
Version
0.1.10
Published
Jul 31, 2026
Downloads
929/mo · 929/wk
Author
exoulster
License
MIT
Types
extension
Size
408 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ],
  "image": "https://raw.githubusercontent.com/1aboveio/pi-better-harness/main/docs/images/package-gallery/pi-better-subagents.png"
}

Security note

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

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