Overview
The Orchestrator is a per-repository meta-agent that monitors, coordinates, and learns from all your agents. It acts like a team lead — tracking progress, managing goals, maintaining memory, and stepping in when agents need help.Enabling
Enable the orchestrator in repository settings:- Open Settings (
Cmd+Shift+P) - Select your repository
- Toggle Orchestrator Enabled
- Optionally configure sampling interval and custom instructions
What It Monitors
The orchestrator automatically tracks events across all workspaces:- Agent completions, errors, and rate limits
- Agents asking questions or waiting for input
- New workspaces created
- Pull requests opened, merged, or failing CI
- Linear issue status changes
- Goal progress
Goals
The orchestrator manages hierarchical goals to keep work organized:- Create goals with a title, description, and rich content
- Link goals to workspaces, agents, Linear issues, or PRs
- Track status from pending through completed
- Nest sub-goals under parent goals
- Attach images with captions
Memory System
The orchestrator learns and remembers across sessions:| Memory Type | What It Stores |
|---|---|
| Preferences | Your working style and preferences |
| Project | Project-specific knowledge and context |
| Corrections | Learnings from past mistakes |
| Outcomes | Results of past decisions |
| Workflows | Recurring patterns and processes |
What It Can Do
The orchestrator can take action on your behalf:- Create new workspaces for tasks it identifies
- Start, pause, resume, or stop agents
- Send messages and instructions to agents
- Update goal status and details
- Send Slack messages to your team
- Suggest next actions to you in the UI
Reflection
The orchestrator periodically reviews recent events and reflects on progress, updating goals and memories accordingly. The reflection interval is configurable in repository settings (default: 30 seconds).Chatting with the Orchestrator
You can chat directly with the orchestrator from the Orchestrator view (Cmd+2). Ask it about progress, request it to create workspaces, or give it high-level instructions about how to coordinate your agents.