What it does
ORRERION ships with a built-in Model Context Protocol server. Any agent that speaks MCP can use it to see the task it’s working on, coordinate with other agents and leave notes for you.
The most common use is a lead agent: one agent plans the work, starts a worker per repo, and checks back on them while you review.
Connecting agents
Agents you start from ORRERION are connected automatically, scoped to their task. There’s nothing to configure.
To turn it off for a workspace, open Settings → MCP and switch off Connect new agents. Agents that are already running keep their connection until they stop.
Tools
Every tool works within the agent’s own task. An agent can’t see or touch other tasks in the workspace.
| Tool | What it does |
|---|---|
list_agents | Agents in the current task, with their status. |
start_agent | Start a Claude Code, Codex or OpenCode agent with a prompt. |
send_to_agent | Send a follow-up message to a running agent. |
agent_status | Whether an agent is running, waiting or idle. |
| Tool | What it does |
|---|---|
list_todos | Open todos for the task. |
add_todo | Add a follow-up so it isn’t forgotten. |
complete_todo | Mark a todo as done. |
| Tool | What it does |
|---|---|
list_docs | Workspace docs, such as architecture notes. |
read_doc | Read a doc into the agent’s context. |
| Tool | What it does |
|---|---|
request_secret | Ask for a credential by name. Waits for your approval. |
An example
Give a lead agent a prompt like this one:
Plan SL-7 across shop-api and storefront. Start one Codex agent per repo
with a focused prompt, add a todo for anything you defer, and tell me
when both are ready for review.
The lead calls start_agent twice, the new lanes appear in the sidebar, and deferred work lands in the task’s todos. You review each diff in the review window as usual.
Approvals and safety
- Secrets:
request_secretalways waits for you. The value goes to the agent’s environment, never into the terminal or the conversation. - Scope: tools only reach the task the agent belongs to.
- No shipping: there is no tool to commit, push or merge. That stays with you, in the review window.
MCP activity
Open MCP activity from the command palette (⌘K) to see every call: which agent made it, when, with what arguments, and what came back. It’s the first place to look when an agent did something you didn’t expect.
Next: Keyboard shortcuts