# pi-subagents

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

## Prompt format

```md
---
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

```json
{
  "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.