48 lines
1.0 KiB
Markdown
48 lines
1.0 KiB
Markdown
# pi-subagents
|
|
|
|
`pi-subagents` is a Pi extension package that runs generic subagent tasks in separate child sessions and ships workflow prompt templates plus the wrapper code needed to execute those runs.
|
|
|
|
## Install
|
|
|
|
Local path:
|
|
|
|
```bash
|
|
pi install /absolute/path/to/subagents
|
|
```
|
|
|
|
Git:
|
|
|
|
```bash
|
|
pi install https://gitea.rwiesner.com/pi/pi-subagents
|
|
```
|
|
|
|
## Resources
|
|
|
|
- Extension: `./index.ts`
|
|
- Prompts: `./prompts/*.md`
|
|
|
|
## Runner modes
|
|
|
|
- default: background child process runner
|
|
- optional tmux runner: set `{"runner":"tmux"}` in `.pi/subagents.json` or `~/.pi/agent/subagents.json`
|
|
|
|
## What a subagent run gets
|
|
|
|
- delegated task text
|
|
- selected model
|
|
- optional working directory
|
|
|
|
Child runs are normal Pi sessions. This package does not add built-in role behavior, markdown-discovered subagents, per-agent tool restrictions, or appended role prompts.
|
|
|
|
## Requirements
|
|
|
|
- default process runner: no tmux requirement
|
|
- optional tmux runner: `tmux` must be available on `PATH`
|
|
|
|
## Development
|
|
|
|
```bash
|
|
npm install
|
|
npm test
|
|
```
|