Pi Better Harness

pi-better-harness is a Pi extension bundle for delegated subagents, durable background shell tasks, and goal tracking that stays aware of background work.

Quick Answer

Use Pi Better Harness when a Pi session needs to keep moving while related work runs elsewhere. Install the bundle with pi install npm:pi-better-harness, or install only the individual extension you need.

Install The Bundle

Install the full bundle:

pi install npm:pi-better-harness

Install only one part:

pi install npm:pi-better-subagents
pi install npm:pi-better-background-tasks
pi install npm:pi-better-goal

Try the bundle for one run without saving it to Pi settings:

pi -e npm:pi-better-harness

When To Use

Use this repo when you want Pi to delegate independent work, supervise long shell commands, or keep an explicit objective open until background work has drained.

Do not use the bundle when you only need one extension; install that package directly instead.

Packages

• pi-better-subagents: detached, sandboxed subagent runs.
• pi-better-background-tasks: durable shell tasks, watchers, logs, and status inspection.
• pi-better-goal: objective tracking with background-aware continuation.

pi-better-read-aloud lives in this repo but is not published or included in the meta package yet.

Compatibility

Requirement	Support
Pi	Required
Install method	pi install npm:...
Development runtime	Node.js 22+

Development

Use Node.js 22 or newer.

npm install
npm run verify

Load this checkout directly in Pi while developing:

pi -e .

Docs

• Development and release notes
• Subagents details
• Background tasks details
• Goal details
• License