pi-better-harness

Pi extension bundle for subagents, durable background tasks, and goal tracking.

Packages

Package details

extension

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

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

Security note

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

README

pi-better-harness

pi-better-harness is a Pi meta package that installs the core Pi Better Harness extensions for delegated subagents, durable background tasks, and goal tracking.

Quick Answer

Use pi-better-harness when you want the full background-work set for Pi. It manages:

  • pi-better-subagents for detached, sandboxed subagent runs.
  • pi-better-background-tasks for durable shell tasks and watchers.
  • pi-better-goal for objective tracking that is aware of background work.

pi-better-read-aloud is intentionally not included yet.

Screenshots

Install

Install the three extensions as standalone Pi packages, so Pi displays and manages each by its own package name:

npx pi-better-harness install

For project-local Pi settings:

npx pi-better-harness install --local

The bundled installation remains available for compatibility:

pi install npm:pi-better-harness

When To Use

Use the installer when you want all three core extensions with standalone package identities. Install an individual package instead when you only need subagents, shell task supervision, or goal tracking.

Compatibility

Requirement Support
Pi Required
Recommended install npx pi-better-harness install
Development runtime Node.js 22+

Update Or Remove

Remove all three standalone packages:

npx pi-better-harness uninstall

Add --local to remove them from project-local settings.

More Detail