@chaotic1988/pi-subagent

A [pi](https://github.com/mariozechner/pi) extension for delegating tasks to subagents. Each subagent runs as an in-process SDK session with its own isolated context window — ideal for parallel work, specialist prompts, or keeping noisy subtasks out of yo

Packages

Package details

extensionskill

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

npm report

$ pi install npm:@chaotic1988/pi-subagent

Package: @chaotic1988/pi-subagent
Version: 0.2.1
Published: Jul 20, 2026
Downloads: 93/mo · 5/wk
Author: chaotic1988
License: unknown
Types: extension, skill
Size: 59.1 KB
Dependencies: 0 dependencies · 5 peers

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

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

README

pi-subagent

A pi extension for delegating tasks to subagents. Each subagent runs as an in-process SDK session with its own isolated context window — ideal for parallel work, specialist prompts, or keeping noisy subtasks out of your main session.

Install

pi install npm:@chaotic1988/pi-subagent

Quick Start

1. Define an agent (e.g. ~/.pi/agent/agents/reviewer.md):

---
name: reviewer
description: Reviews code for quality and correctness
---

You are a thorough code reviewer. Focus on correctness, clarity, and edge cases.
Respond with a brief summary followed by a bullet list of specific issues.

2. Use it in a task

Single agent:

{
  "agent": "reviewer",
  "task": "Review src/auth.ts for security issues"
}

Parallel agents:

{
  "tasks": [
    { "agent": "reviewer", "task": "Review src/auth.ts" },
    { "agent": "reviewer", "task": "Review src/api.ts" },
    { "agent": "reviewer", "task": "Review src/utils.ts" }
  ]
}

For full documentation — agent configuration, discovery rules, frontmatter reference, and more — see the User Guide.