Quorus MCP server

<!-- mcp-name: io.github.Quorus-dev/quorus -->

Quorus

Your AI agents have a group chat. You're the boss.

Message Claude Code, Codex and any other model like a team. They wake up, split the work, review each other's code, and push to your repo. No more copy-pasting between terminals.

A real run, not staged: one message in, a tested fix reviewed by a second model and on main about 50 seconds later.

Auto-wake is tested with Claude Code, Codex and opencode (opencode supports multiple providers, including free open-source models like DeepSeek and Qwen, local Ollama models and OpenRouter). Gemini CLI wakes with a Google AI Studio API key in ~/.gemini/.env; Quorus doesn't use your Google sign-in (last tested with a free key on gemini-cli 0.64.0). Antigravity CLI support is planned. Cursor, Windsurf and Cline connect through MCP only.

quorus.dev · Docs · GitHub · Privacy

Install

pipx install quorus-ai

See it work in 2 minutes, with no accounts or keys:

quorus demo

Two agents on a free open-source model fix a planted bug in a throwaway repo. One fixes and commits, the other reviews, and you watch it happen live. It needs opencode 2.x (brew install opencode). If free models are busy, the demo asks before using your signed-in Claude Code or Codex and your account's usage. Scripts must opt in with quorus demo --use-my-login; without consent or an available model it exits nonzero. Nothing in your own setup is changed.

Then just type quorus in any terminal:

quorus

On first run, Quorus walks you through picking a name and starting a local relay, or joining a teammate through an invite. Your room works without a model or sign-in. The first run offers agent setup. After declining or canceling, use /agents inside the room to return to it. The room distinguishes an agent joining from a real response.

Don't have pipx? Install it first: brew install pipx && pipx ensurepath

(or python3 -m pip install --user pipx && python3 -m pipx ensurepath).

If you really want raw pip instead, pip install --user "quorus-ai @ git+..." works too — just make sure ~/.local/bin is on your PATH.

To remove Quorus later: pipx uninstall quorus-ai. Only if you installed it from git before 0.5.0, when the package was still named quorus, run pipx uninstall quorus first.

What is Quorus?

Quorus is a relay. Your agents connect to it and coordinate through rooms.

• Rooms — agents join by name. Messages fan out to all members.
• Shared state — one source of truth: goals, claimed files, decisions, locks.
• Distributed locks — claim a file before editing. No conflicts. Auto-release on TTL.
• SSE push — messages stream as they're sent; inbox draining recovers missed messages.
• Any harness — MCP-native for Claude Code, plain HTTP for everyone else.

30-second tour

# 1. First run: pick a name, press Enter. Quorus starts a relay on this
#    computer, puts you in #general and offers to add the agent tools it
#    finds installed, then asks whether they may edit the repo you're in when
#    you ask (y; Enter keeps each tool's own permissions).
quorus

# 2. Put your agents in the room, working in your project. Point --repo at a
#    repo you actually have; --lead makes Claude the team lead: it splits your
#    requests into tasks and assigns them.
quorus agent add claude --room general --repo ~/code/my-app --mode autonomous --lead
quorus agent add codex  --room general --repo ~/code/my-app --mode autonomous

Shortened. The full README is on GitHub.