@deathbeam/pi-delegate

Run focused subagents with delegate, delegate_list, delegate_steer, and delegate_cancel. Use /delegate command to inspect 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 my packages

Configuration

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

{
    "delegate": {
        "agentDirs": ["./.pi/agents"],
        "models": {
            "cheap": { "model": "anthropic/claude-haiku-latest", "thinking": "low" },
            "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); a tier is a provider/model string or a { "model": "...", "thinking": "..." } object, otherwise the child uses the current session model and thinking level. Thinking resolves from the agent frontmatter first, then the tier entry, then the session level.

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. The model sees the agent list from when the extension loaded, so run /reload after adding agents or changing their descriptions.

The main session is prompted to act as an orchestrator. When it makes 5, 10, 20, … direct exploration calls (read, grep, find, ls, shell, web tools) without delegating, a hidden reminder nudges it to delegate the rest. The count resets on each prompt and each delegate call.

Development

From this package directory:

npm install
npm test
pi install .