Subagent Extension

A Pi extension that delegates tasks to specialized agents in isolated contexts.

Tool

subagent

Delegate tasks to specialized agents. Spawns a separate pi process for each invocation with isolated context.

Modes

Single Mode

Run one agent with one task.

{
  "agent": "worker",
  "task": "List all files in the current directory"
}

Parallel Mode

Run multiple agents concurrently.

{
  "tasks": [
    { "agent": "worker", "task": "Task 1" },
    { "agent": "worker", "task": "Task 2" }
  ]
}

Chain Mode

Run agents sequentially, passing output to the next step via {previous} placeholder.

{
  "chain": [
    { "agent": "worker", "task": "Generate a list of items" },
    { "agent": "worker", "task": "Process these items: {previous}" }
  ]
}

Parameters

| Name | Type | Required | Description | | ---------------------- | ------- | -------- | ------------------------------------------------------ | | agent | string | No | Agent name (for single mode) | | task | string | No | Task description (for single mode) | | tasks | array | No | Array of {agent, task} (for parallel mode) | | chain | array | No | Array of {agent, task} (for chain mode) | | cwd | string | No | Working directory for the agent | | agentScope | string | No | user, project, or both (default: user) | | confirmProjectAgents | boolean | No | Prompt before running project agents (default: true) |

Agent Discovery

Agents are discovered from:

• User agents: ~/.pi/agent/agents/
• Project agents: .pi/agents/ (in project root)