subagents

name	subagents
description	invoke this skill when the user asks you to use subagents

Subagents

Each subagent is headless, has its own context window, cannot see the parent conversation, cannot ask the user, and cannot spawn subagents or workflows. Give every child a self-contained prompt with paths, constraints, and the expected report.

Pi Harness

Harness: pi Prompt nicknames: “pi”, “pi agent”, “pi subagent” Best default: Use when the user does not request another harness. It inherits the parent model and thinking level when model or reasoning_effort is omitted.

Do not use models from the Anthropic provider even if one appears in the model list.

Pi can use any model shown by pi --list-models. Prefer provider/model-id; a bare model id only works when unambiguous. Common picks in this environment:

Model	Recommended effort
inherited parent model (default)	inherited
openai-codex/gpt-5.6-sol	high
openai-codex/gpt-5.6-terra	high
opencode/claude-fable-5	medium

Thinking budgets: off, minimal, low, medium, high, xhigh, max. These map directly to pi thinking levels.

Claude Code Harness

Harness: claude Prompt nicknames: “claude”, “Claude Code”, “claude agent”, “claude subagent”, "cc" Best default: use the latest fable model on high reasoning. Do not default to anything else, if the user does not specify, use fable.

Model hint	Model	Recommended effort
fable	latest Claude Fable	high

Thinking budgets: off, minimal, low, medium, high, xhigh, max. The extension maps these to Claude thinking-token budgets: 0, 1,024, 4,096, 10,000, 16,000, 32,000, and 63,999 tokens respectively.

Requires Claude Code to be installed and authenticated.

Codex Harness

Harness: codex Prompt nicknames: “codex”, “Codex CLI”, “codex agent”, “codex subagent” Best default: gpt-5.6-sol with high effort for coding work. Do not use anything other than sol unless the user specifically asks for it.

Model	Recommended effort
gpt-5.6-sol	high
gpt-5.6-terra	high
gpt-5.6-luna	high

Thinking budgets accepted by the extension: off, minimal, low, medium, high, xhigh, max. Codex maps these to the nearest effort supported by the selected model; off/minimal become minimal, while max becomes the highest extension-supported Codex effort.

Requires the Codex CLI to be installed and authenticated.

Spawn and Manage

Call subagent_spawn with a complete prompt, short name, chosen harness, and optional working_dir, model, and reasoning_effort. At most four subagents run concurrently.

• subagent_check({ id }): peek without blocking.
• subagent_list(): list all runs.
• subagent_wait({ ids }): block only when results are required to proceed.
• subagent_cancel({ ids }): stop runs while preserving partial transcripts.
• /subagents: inspect or take over a run interactively.

Results return automatically. After spawning, continue useful parent work instead of immediately waiting.