32 lines
895 B
Markdown
32 lines
895 B
Markdown
# 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.
|