@hyperprior/pi-subagent

Delegate tasks to isolated sub-agents (pi subprocesses)

Package details

extension

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

$ pi install npm:@hyperprior/pi-subagent
Package
@hyperprior/pi-subagent
Version
0.1.0
Published
Feb 16, 2026
Downloads
12/mo · 5/wk
Author
hyperprior
License
MIT
Types
extension
Size
18.4 KB
Dependencies
1 dependency · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

@hyperprior/pi-subagent

Launch isolated subagent runs through pi subprocesses.

Installation

pi install npm:@hyperprior/pi-subagent

Features

  • hyperpi_subagent tool with execution modes:
    • single: one task
    • parallel: run multiple tasks with bounded concurrency
    • chain: sequential tasks where each task can reference {previous}
  • Per-task model/tool/cwd overrides
  • /subagent <task> quick command for one-off runs

Example payloads

{
  "mode": "single",
  "task": "List the top 3 risks in the current diff.",
  "model": "sonnet",
  "tools": "bash,git"
}
{
  "mode": "parallel",
  "tasks": [
    { "task": "Run targeted tests for payment module.", "agent": "qa" },
    { "task": "Run static scan for hardcoded secrets.", "agent": "security" }
  ]
}
{
  "mode": "chain",
  "chain": [
    { "task": "Summarize open PR comments." },
    { "task": "Create a patch plan based on previous summary: {previous}" }
  ]
}

Notes

All plugins in this monorepo are namespaced under @hyperprior and built to be loaded as individual pi packages.