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