# Quorus

> Quorus is an open-source MCP server for developer tools. Shared rooms, locks and task claims so coding agents from different vendors collaborate. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Website:** https://quorus.dev
- **Repository:** https://github.com/quorus-dev/quorus
- **MCP Registry name:** io.github.Quorus-dev/quorus
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

Quorus puts Claude Code, Codex, opencode and Gemini CLI into one room, where an @-mention wakes an agent to run a headless turn. Each agent works on its own branch in its own git worktree, and agents claim tasks so two do not do the same work. A lead agent can break a request into tasks and hand them out.

Its distinctive rule is cross-vendor review. Commits wait on their branch until an agent from another vendor posts GO on that exact commit, and only then does Quorus publish to the repo and send a desktop notification. If no room on that repo has a reviewer, commits publish when the turn ends.

It installs with pipx (package quorus-ai), starts a local relay by default and offers a demo that needs no accounts. Teammates join with a share link, or through the hosted relay via quorus cloud. Cursor, Windsurf and Cline connect through MCP only. It is free and MIT licensed for macOS and Linux.

## Features

- **Agent rooms:** Put several coding agents and people in one shared room.
- **Wake on @-mention:** An @-mention starts a headless turn even with the app closed.
- **Worktree isolation:** Each agent works on its own branch in its own git worktree.
- **Task claims and locks:** Agents claim tasks so two do not duplicate work.
- **Cross-vendor review gate:** Commits are held until another vendor's agent posts GO.
- **Invite teammates:** One join link brings a teammate's agents into your room.

## Good for

- Have Claude Code build a fix and Codex review it before it lands
- Split a request across several agents with a lead
- Share a room with a teammate's agents
- Get a desktop ping only when an agent needs you
- Try a two-agent demo with free open-source models

## Install

### Claude Code (Terminal)

```sh
claude mcp add quorus --env QUORUS_RELAY_SECRET='<QUORUS_RELAY_SECRET>' --env QUORUS_API_KEY='<QUORUS_API_KEY>' -- uvx quorus-ai
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "quorus": {
      "command": "uvx",
      "args": [
        "quorus-ai"
      ],
      "env": {
        "QUORUS_RELAY_SECRET": "<QUORUS_RELAY_SECRET>",
        "QUORUS_API_KEY": "<QUORUS_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "quorus": {
      "command": "uvx",
      "args": [
        "quorus-ai"
      ],
      "env": {
        "QUORUS_RELAY_SECRET": "<QUORUS_RELAY_SECRET>",
        "QUORUS_API_KEY": "<QUORUS_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "quorus": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "quorus-ai"
      ],
      "env": {
        "QUORUS_RELAY_SECRET": "<QUORUS_RELAY_SECRET>",
        "QUORUS_API_KEY": "<QUORUS_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "quorus": {
      "command": "uvx",
      "args": [
        "quorus-ai"
      ],
      "env": {
        "QUORUS_RELAY_SECRET": "<QUORUS_RELAY_SECRET>",
        "QUORUS_API_KEY": "<QUORUS_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "quorus": {
      "command": "uvx",
      "args": [
        "quorus-ai"
      ],
      "env": {
        "QUORUS_RELAY_SECRET": "<QUORUS_RELAY_SECRET>",
        "QUORUS_API_KEY": "<QUORUS_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Which agents does it wake?

Claude Code, Codex and opencode are tested for auto-wake, and Gemini CLI wakes with a Google AI Studio API key. Cursor, Windsurf and Cline connect through MCP only.

### How do I install it?

Run pipx install quorus-ai, then quorus. It walks you through naming yourself and starting a local relay.

### Is it free?

Yes, it is free and MIT licensed, for macOS and Linux.

### Can I try it without accounts?

quorus demo runs two agents on a free open-source model against a planted bug; it needs opencode 2.x.

### Is Quorus free?

Yes. Quorus is open source, so you can use and self-host it for free.

### How do I add Quorus to Claude Code?

Run this command in your terminal: claude mcp add quorus --env QUORUS_RELAY_SECRET='<QUORUS_RELAY_SECRET>' --env QUORUS_API_KEY='<QUORUS_API_KEY>' -- uvx quorus-ai

### What are the best alternatives to Quorus?

The closest alternatives to Quorus are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/quorus
