pi-subagents/README.md

pi-subagents

Pi extension that registers a subagent tool. Subagents are defined by markdown prompts in prompts/*.md.

Prompt format

---
name: scout
description: Fast codebase reconnaissance
approved_tools:
  - read
  - bash
---
System prompt for the subagent goes here.

• approved_tools / allowed_tools is whitelist mode: the subagent receives only those tools.
• denied_tools is blacklist mode: the subagent inherits currently active tools except those tools and subagent itself.
• Do not define whitelist and blacklist fields together; the extension rejects ambiguous configs.

Tool usage

{
  "agent": "scout",
  "task": "Find where authentication middleware is registered"
}

The extension spawns an isolated pi --mode json -p --no-session subprocess with the prompt appended as system instructions and --tools set to the resolved tool list.