@deathbeam/pi-delegate

Run focused subagents with delegate, delegate_list, delegate_steer, and delegate_cancel. Use /delegate command to view and manage jobs in a full-screen TUI.

Installation

# Choose one:
pi install npm:@deathbeam/pi-delegate            # this package
pi install git:github.com/deathbeam/pi-packages  # all four packages

Configuration

Optional delegate settings live in ~/.pi/agent/settings.json or .pi/settings.json:

{
    "delegate": {
        "agentDirs": ["./.pi/agents"],
        "models": {
            "cheap": "anthropic/claude-haiku-latest",
            "balanced": "anthropic/claude-sonnet-latest",
            "strong": "anthropic/claude-opus-latest"
        }
    }
}

Relative agentDirs resolve against the project cwd, later same-name definitions win. Project models override global tiers (cheap, balanced, strong), otherwise the child uses the current session model.

Agents are Markdown files with frontmatter, the body becomes the child's system prompt:

---
name: scout
description: Explore the codebase
tools: read, grep
model: cheap
thinking: low
---

Explore the codebase and report relevant paths.

Omit tools to inherit active tools. model can also be an explicit provider/model.

Development

From this package directory:

npm install
npm test
pi install .