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.