Mohamed Boudra
da8c1b5c94
* docs(orchestration): lead with capabilities and practical delegation * docs(orchestration): correct model requirements and agent list scope
4.0 KiB
title, description, nav, order, category
| title | description | nav | order | category |
|---|---|---|---|---|
| Orchestration | Coordinate agents across providers and machines, delegate work, and keep tasks moving with schedules and heartbeats. | Overview | 30 | Orchestration |
Orchestration
Paseo lets your coding agents coordinate other agents, split work across providers and machines, and keep tasks moving automatically.
What your agents can do
- Choose providers and models: launch other agents using any provider and model configured on the host.
- Delegate and parallelize: split research, implementation, and review between agents, including agents from different providers.
- Communicate with each other: agents can send prompts to other agents by ID to ask questions, share findings, or request work.
- Coordinate ongoing work: check progress, stop tasks, and collect results.
- Create workspaces and worktrees: give independent changes their own working directories.
- Work across machines: use the CLI to launch and manage agents on another reachable Paseo host.
- Choose by specialty: use agent profiles and their notes to select settings for UI work, planning, or reviews.
- Create schedules: run a prompt in a new agent at specified times.
- Create heartbeats: prompt the same agent periodically to continue its task.
Get started
Use built-in Paseo tools or the CLI. Both let an agent launch and coordinate workers.
Built-in Paseo tools (MCP)
Enable Paseo tools so agents running inside Paseo can manage agents and workspaces on their host directly.
- Open Settings → your host → Agents.
- Turn on Enable Paseo tools. Tool injection is off by default.
- Start a new agent, or reload an existing agent so it receives the tools.
- Ask:
Use Paseo to launch a second agent to review this branch. Have it report potential bugs without changing files, then summarize its findings.
The worker appears in the Subagents track near the composer. Open it to follow the conversation. Your main agent receives a notification when the worker finishes, and you can keep talking while it works.
See the MCP reference for tool configuration and the full catalog. Orchestration skills are optional reusable workflows.
CLI
Agents with shell access can also use the Paseo CLI. This route does not require enabling tool injection. With Paseo installed, a running host, and Codex configured:
paseo run --provider codex --background \
"Review this branch without changing files"
paseo ls -a
The first command starts a worker and returns immediately; the second lists agents from active workspaces, including archived agents. When a Paseo agent runs the command, the worker becomes its subagent in the same workspace. From your own terminal, it starts in a new local workspace.
See the CLI reference for follow-ups, output, worktrees, and remote hosts.
Pick settings once with profiles
Save a provider, model, thinking level, mode, and available feature settings as an agent profile, then select it in one click when creating an agent.
Add When to use notes so an orchestrating agent can choose a profile for the task: UI work, planning, or independent review. Create profiles and write delegation notes.