Subagents and coordination¶

Subagents execute focused assignments in child sessions. Each starts with its own conversation; the parent's transcript is not automatically copied. Workers inherit the resolved provider and reasoning settings.

Delegation tools¶

Tool	Behavior
`Task`	Wait for a delegated result; `run_in_background` returns early
`AgentTool`	Start a persistent worker and return its id
`SendMessage`	Deliver another assignment to a worker
`AgentStop`	Cancel a worker

Spawning requires approval unless a rule or remembered grant allows it. Results arrive in the parent conversation with the worker's terminal status.

Following along¶

Control	Action
`Ctrl+W`	Open the agents picker, including a single worker
`Enter` in the picker	Open the selected agent's session
`Alt+Left`	Return one drill-in level without cancelling the agent
`Alt+S`	Open the global sessions list
`Ctrl+J`	Open Bash jobs

gdc sessions list --tree
gdc sessions list --root-only

Coordinated multi-agent work¶

The coordinator profile delegates research, implementation and verification and combines results. It cannot edit files or execute shell commands directly.

gdc print --profile coordinator --auto-approve \
  "audit input validation in every module and summarise findings"

Limits¶

[task]
max_parallel_workers = 2
worker_token_budget_per_turn = "half"
spawn_budget_per_turn = 10
coordinator_turn_wallclock_secs = 600

See task configuration for worker recovery and archive settings. For execution on several machines, see Swarm.