Skip to content
ORRERION
Download

ORRERION · Docs

MCP server

Let agents work with ORRERION itself: start other agents, keep todos and read the workspace docs.

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.

Agents
ToolWhat it does
list_agentsAgents in the current task, with their status.
start_agentStart a Claude Code, Codex or OpenCode agent with a prompt.
send_to_agentSend a follow-up message to a running agent.
agent_statusWhether an agent is running, waiting or idle.
Todos
ToolWhat it does
list_todosOpen todos for the task.
add_todoAdd a follow-up so it isn’t forgotten.
complete_todoMark a todo as done.
Docs
ToolWhat it does
list_docsWorkspace docs, such as architecture notes.
read_docRead a doc into the agent’s context.
Vault
ToolWhat it does
request_secretAsk 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_secret always 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