Files
pi-subagents/README.md

1.0 KiB

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:

pi install /absolute/path/to/subagents

Git:

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

npm install
npm test