@pi-lab/subagent

Minimal synchronous parallel subagent tool for pi coding agent

Package details

extension

Install @pi-lab/subagent from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@pi-lab/subagent

Pi manifest JSON

{
  "extensions": [
    "./dist/index.mjs"
  ]
}

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

A minimal synchronous subagent extension for pi.

pi install npm:@pi-lab/subagent

Schema only — no system-prompt injection
No role files — no *.md specialists. The child uses the same model, tools, and project conventions as the main agent
Simple lifecycle — one prompt per call; parallel execution uses Pi's native tool concurrency
Trigger policy is yours — this tool does not tell the model when to delegate. It follows whatever you define

Isolate context. Add no orchestrator.
You need a tool that just isolates context, not an orchestrator.

Wrap headless pi.
You only want a thin wrapper around headless pi.

One config for parent and child.
The child behaves like the parent. No extra implicit instructions.

Reusable roles, async/steer/fleet, or a workflow DSL. If you need these features, use a larger extension.