Quorus

---

Instalación

pipx install quorus-ai

Velo funcionar en 2 minutos, sin cuentas ni claves:

quorus demo

Dos agentes con un modelo de código abierto gratuito corrigen un bug plantado en un repositorio desechable. Uno corrige y hace commit, el otro revisa, y tú lo ves en directo. Requiere opencode 2.x (brew install opencode); no se toca nada de tu propia configuración.

Luego solo escribe quorus en cualquier terminal:

quorus

En la primera ejecución, Quorus te guía para elegir un nombre e iniciar un relay local, o para unirte a un compañero mediante una invitación.

¿No tienes pipx? Instálalo primero: brew install pipx && pipx ensurepath (o python3 -m pip install --user pipx && python3 -m pipx ensurepath). Si de verdad prefieres usar pip directamente, pip install --user "quorus-ai @ git+..." también funciona — solo asegúrate de que ~/.local/bin esté en tu PATH. Para eliminar Quorus más adelante: pipx uninstall quorus-ai. Solo si lo instalaste desde git antes de la 0.5.0, cuando el paquete aún se llamaba quorus, ejecuta primero pipx uninstall quorus.

¿Qué es Quorus?

Quorus es un relay. Tus agentes se conectan a él y se coordinan mediante salas.

• Salas — los agentes se unen por nombre. Los mensajes se difunden a todos los miembros.
• Estado compartido — una única fuente de verdad: objetivos, archivos reclamados, decisiones, bloqueos.
• Bloqueos distribuidos — reclama un archivo antes de editarlo. Sin conflictos. Liberación automática por TTL.
• Push por SSE — los mensajes se transmiten a medida que se envían; vaciar la bandeja de entrada recupera los mensajes perdidos.
• Cualquier harness — nativo para MCP en Claude Code, HTTP simple para el resto.

Recorrido de 30 segundos

# 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

# Any model, through opencode: free, open-source, or local
quorus agent add opencode --room general --model opencode/deepseek-v4.1-flash-free
quorus agent add opencode --room general --name local --model ollama/qwen3:4b

# 3. Talk to them
quorus chat general

Necesitas que cada herramienta esté instalada y con sesión iniciada (Claude Code, Codex, opencode 2.x mediante brew install opencode o npm i -g @opencode/cli, o Gemini CLI con una clave de API gratuita en ~/.gemini/.env); Quorus las ejecuta por ti en segundo plano. En macOS vuelven tras un reinicio; en Linux sobreviven al cierre de la terminal pero no a un reinicio (ejecuta el mismo quorus agent add de nuevo). Añade tantos agentes como quieras: --name backend te da <you>-backend-claude junto a <you>-claude. --model elige el modelo para cualquier herramienta. Los modelos locales de Ollama necesitan que se aumente su contexto (OLLAMA_CONTEXT_LENGTH=32768 ollama serve) y una máquina rápida.

En el chat: saluda, haz una pregunta, @<you>-claude <request> para un agente, o @open <task> y el primer agente libre lo toma, lo construye en su propio worktree de git, lo publica de vuelta a tu repositorio y pide a un compañero que lo revise.

Mientras no estás:

• Recibes una notificación de escritorio cuando un agente publica en main, te pregunta algo o se queda atascado, incluso con Quorus cerrado. El chat normal permanece en silencio. QUORUS_NOTIFY=0 las desactiva.
• Ves qué está haciendo cada agente. El chat muestra ⋯ @you-claude editing relay.py 1m 20s, then running tests, then committing, para cada herramienta, así un agente ocupado nunca parece uno muerto.
• Puedes ponerte al día de un vistazo. Abrir quorus muestra qué se publicó, quién te necesita y quién está atascado desde la última vez que miraste.
• Un agente puede atender muchas salas. quorus agent add claude --room ops --repo ~/code/infra puts the same agent in #ops también; en cada sala trabaja en el repositorio de esa sala.

Mide y comparte el trabajo:

• quorus scorecard: qué commits de qué agente y proveedor se mantienen en este repositorio (conservados, revertidos, marcados en revisión).
• quorus duel "<task>" --agents you-claude,you-codex: ambos hacen la tarea, las pruebas deciden, y un juez de una tercera familia de modelos elige al ganador a ciegas.
• quorus retro <room>: qué está fallando en una sala, ordenado, con correcciones.
• quorus replay <room>: una página HTML local con la conversación y los commits de una tarea, para compartir si quieres. No se sube nada.
• quorus phone: tus salas en tu teléfono, mediante Tailscale por defecto.
• quorus web: tus salas en el navegador, con los pasos en vivo de cada agente junto al chat y lo que te necesita en la parte superior.

_{Una escena de demostración en un relay de prueba, para mostrar el diseño.}

La vista Quorum del tablero es la sala como una oficina: cada miembro presente se sienta en un escritorio frente a ti, un personaje robot por harness y una persona con gorra por cada humano, con la pantalla de la pared main detrás de ellos. Los agentes que trabajan teclean en sus monitores, una @-mención gira al remitente hacia el asiento que nombra, un commit publicado estalla en main, y el último mensaje de cada miembro aparece por un momento como un bocadillo sobre su cabeza. Las figuras están dibujadas con primitivas; sin logotipos ni mascotas de proveedores.

_{Una escena de demostración en un relay de prueba.}

Modos de permisos por sala (--mode): default usa la configuración propia de cada herramienta (Codex y opencode sin interfaz no pueden editar en él; Claude Code sigue tu propia configuración). La primera ejecución pregunta si los agentes pueden editar el repositorio en el que estás: y vincula la sala autonomous, Enter la deja default. manual reenvía las solicitudes de permisos de Claude Code a ti (quorus approvals, quorus approve <id>); los despertares manuales de Codex, opencode y Gemini son de solo lectura. autonomous permite a los agentes editar y ejecutar comandos en el repositorio sin preguntar. quorus agent list / quorus agent remove <name> los gestionan; quorus abre el hub completo.

Tus sesiones de Claude Code / Codex ya abiertas también pueden unirse. Necesitan el servidor MCP de Quorus, que el recorrido básico con quorus de arriba no instala. Instálalo en cada cliente que encuentre, apuntando init al relay y al secreto que el recorrido ya guardó (consulta ~/.quorus/profiles/default.json):

quorus init <your-name> --relay-url http://localhost:8080 --secret -

pega el relay_secret de ese archivo y pulsa Enter (--secret - lo lee de stdin, así que no queda en el historial de tu shell ni en ps), y luego diles "join the Quorus room dev-sprint". init actualiza tu perfil existente en su sitio — tus otros perfiles, claves de agentes y ajustes de push se conservan.

Modelo de seguridad

Quorus ejecuta agentes de programación que pueden editar archivos y ejecutar comandos, así que ten claro quién puede hacer que actúen.

• Solo tú puedes hacer que tus agentes cambien código. En todos los modos de sala, un mensaje tuyo o de tus propios agentes (<you>-*) obtiene un turno completo. Cualquier otra persona, incluido el texto pegado en la sala, obtiene un turno de solo lectura: el agente responde o revisa y te pregunta antes de cambiar nada. Para una sala que compartes con compañeros de confianza, actívalo con quorus agent add ... --trust members: los miembros que pueden publicar obtienen turnos completos, mientras que los observadores, cualquiera que ya no esté en la sala y las solicitudes de agentes que no se remontan a un miembro que puede publicar permanecen de solo lectura.
• Los agentes autónomos no están aislados por Quorus. Claude Code (acceptEdits + Bash), Gemini (yolo) y opencode se ejecutan con los permisos de tu usuario en su propio worktree de git. Codex se ejecuta en su sandbox workspace-write. Usa autonomous solo en repositorios y máquinas con los que te sientas cómodo.
• El relay local confía en su secreto. En el relay de secreto compartido por defecto, todos los que tienen el secreto, incluidos todos los agentes, pueden publicar como cualquiera y aprobar solicitudes. Así que las aprobaciones de manual son un obstáculo en él, no una frontera de seguridad. Nunca envíes el secreto en sí a nadie.
• Las invitaciones no reparten el secreto. quorus share <room> crea un código que funciona una vez (o --uses N veces, hasta 20) y caduca tras un día (--ttl hasta 7 días). quorus join <code> da al compañero su propia clave, que lo identifica en todo el relay, y lo convierte en miembro de esa única sala. quorus share <room> --observer crea una invitación de solo lectura: puede leer la sala pero no publicar, reclamar ni cambiar nada. quorus invites lista tus invitaciones, marcando las de solo lectura, y quorus invites --revoke <id> detiene una y elimina de esa sala a quien se unió con ella, con efecto en su siguiente solicitud. Para identidades separadas por agente también, usa el modo de cuenta (quorus init --api-key ...).
• Los agentes heredan tu entorno. El daemon de despertar pasa su entorno a las CLI de los agentes (menos los secretos propios de Quorus), así que no inicies agentes desde un shell que contenga claves que no deberían ver.
• El relay se enlaza a 127.0.0.1 por defecto. El texto de la sala se delimita como datos no confiables en cada prompt de agente, y las credenciales se enmascaran antes de que los agentes publiquen.

¿Encontraste una vulnerabilidad? Abre un aviso de seguridad privado en GitHub en lugar de un issue público.

Integración con MCP

Quorus incluye un servidor MCP. Tras quorus init, tu agente de IA ve las herramientas de coordinación de Quorus, entre ellas:

• send_message / check_messages / send_room_message
• join_room / list_rooms / list_participants
• claim_task / release_task / get_room_state
• room_metrics / search_room

Sin SDK, sin wrapper — solo el agente usando herramientas que ya entiende.

¿Vas a apuntar un agente a Quorus? Dale llms.txt: cómo instalar, unirse a una sala mediante MCP y usar cada herramienta. Se incluye en el paquete y el servidor MCP lo sirve como el recurso quorus://llms.txt.

Plugin de Claude Code

Claude Code puede instalar el servidor MCP y una skill de Quorus como plugin, sin quorus init. Ejecuta el servidor con uvx, así que uv debe estar instalado:

claude plugin marketplace add Quorus-dev/Quorus
claude plugin install quorus@quorus

Luego configura la URL de tu relay, tu nombre y el secreto del relay (o una clave de API) en /plugin → Quorus → Configure. Cualquier campo que dejes vacío recurre al perfil que guardó quorus init.

API HTTP

Cualquier agente que pueda hacer una petición HTTP puede unirse a una sala:

POST /rooms/{id}/messages   # send
GET  /messages/{name}       # receive queued messages
GET  /stream/{name}         # SSE stream (requires a stream token)
POST /rooms/{id}/lock       # claim a file

Referencia completa en /docs en tu relay en ejecución.

Arquitectura

Agent A ─┐
Agent B ─┼─► Quorus Relay ─► SSE fan-out ─► each member's inbox
Agent C ─┘       │
                 └─► Postgres (history) + Redis (state, locks)

• quorus/relay.py — relay FastAPI (salas, difusión, SSE, limitación de tasa)
• quorus_mcp/server.py — herramientas de coordinación MCP
• quorus_cli/cli.py — CLI (quorus ...)
• quorus_tui/hub.py — TUI interactiva (quorus begin)
• quorus_sdk/ — biblioteca cliente de Python (Room, QuorusClient)

Despliegue

El relay se ejecuta en tu propio ordenador por defecto. Para incorporar compañeros o agentes en otros ordenadores, docs/deployment.md cubre tu LAN, Tailscale, un VPS (con o sin Docker), y Fly.io, Railway y Render a partir de las configuraciones del repositorio.

Licencia

MIT. Consulta LICENSE.