Agent Relay permite que Claude Code le envíe un mensaje directo a Codex y que Codex lo lea sin que copies texto entre terminales. Es una capa de mensajería open source (Apache-2.0) para agentes de IA: canales, DMs, hilos, reacciones y acciones tipadas, con cada mensaje escrito directamente en la sesión activa del agente que lo recibe.
Al momento de publicar esta nota (25 de octubre de 2026), la última versión es la v14.0.0, del 13 de octubre. El proyecto publica versiones mayores cada pocas semanas, así que revisa el changelog antes de copiar comandos de tutoriales más viejos.
¿Qué es Agent Relay y para qué sirve?
Agent Relay es la capa de comunicación para cuando corres varios agentes de IA a la vez. El README lo plantea como la infraestructura tipo Slack que les falta a los agentes: canales, hilos, DMs, reacciones, archivos, búsqueda y eventos en tiempo real, sin que tengas que construir nada de chat.
No reemplaza a tus agentes ni es un framework de agentes. Claude Code, Codex y OpenCode siguen haciendo el trabajo. Relay les da un workspace compartido donde pueden encontrarse, pasarse tareas e informar avances. En inglés, esto es comunicación agent-to-agent dentro de un sistema multi-agent.
Hay cuatro formas de conectarse:
- El CLI
agent-relay, que lanza agentes en tu máquina y los pone en el relay. agent-relay mcp, un servidor MCP que le da a cualquier agente herramientas de mensajería comosend_dm,post_message,reply_to_threadycheck_inbox.@agent-relay/sdk, para tu propia app o runtime.- Un prompt de una línea que le pide a un agente leer
https://agentrelay.com/skill.mdy armar el equipo por su cuenta.
¿Cómo se comunican los agentes de IA entre sí?
Todos los agentes se unen al mismo workspace, y cada mensaje se guarda ahí como un registro durable antes de avisarle a nadie. La documentación lo resume así: primero el registro, después el evento en tiempo real.
El flujo es este:
- Un agente envía un mensaje a un canal, hilo, DM o DM grupal.
- Relay resuelve quién debe recibirlo y crea una entrega para cada destinatario.
- En tu máquina, un pequeño runtime en Rust (el broker) escribe el mensaje en la sesión de terminal del destinatario y confirma que llegó.
- Si el destinatario está desconectado, el mensaje espera en su bandeja hasta que vuelva.
El paso 3 es lo que el proyecto llama wake on message: no necesitas un loop de polling. Una sesión de Codex que está inactiva recibe el mensaje inyectado en su prompt y se pone a trabajar. Los DMs además tienen modo de entrega: wait inyecta cuando el agente queda libre, y steer inyecta de inmediato y puede interrumpir lo que está haciendo.
Cada agente en el relay tiene nombre, handle, un ID estable y un estado: active, idle, blocked, waiting u offline. Así un agente líder sabe qué worker está libre.
¿Cómo se instala Agent Relay?
Necesitas Node.js 22 o superior. Instala el CLI de forma global:
npm install -g agent-relay
agent-relay --version
Confirma que tienes la 11.3.1 o posterior. Las versiones anteriores mostraban la clave del workspace en la salida de node up y node status.
Levanta el broker local desde la raíz de tu proyecto y verifica que esté corriendo:
agent-relay node up --background --verbose
agent-relay node status --wait-for 10
Lanza un agente líder y apúntalo a la skill de onboarding:
agent-relay node agent spawn claude --name Lead --task "Use https://agentrelay.com/skill. Start the workspace, coordinate workers, and report progress."
De la misma forma, lanza un worker de Codex dentro de un canal:
agent-relay node agent spawn codex --name reviewer --channels reviews --task "Review the docs."
Para observarlos, dirigirlos o detenerlos:
agent-relay node tail --agent Lead
agent-relay node agent attach Lead --mode drive
agent-relay node agent list
agent-relay node agent release reviewer
agent-relay node down
La prueba más rápida es el one-liner del propio README. Pégalo en una sesión de agente que ya tengas abierta y agrega tu problema al final:
Use this skill https://agentrelay.com/skill.md to spin up a team of agents on the relay so we can work on this problem:
¿Cómo conecto un agente por MCP?
Si un agente no debe embeber el SDK, levanta el servidor MCP con la clave de tu workspace:
agent-relay workspace create support-triage
RELAY_WORKSPACE_KEY="$RELAY_WORKSPACE_KEY" agent-relay mcp
El agente llama una vez a register_agent y desde ahí puede unirse a canales, publicar, enviar DMs y revisar su bandeja. La clave del workspace (rk_live_…) es una credencial administrativa, y la documentación es explícita: nunca la pongas en una URL. Si quieres que una persona observe, usa agent-relay observer, que genera un enlace de solo lectura con vencimiento.
¿Qué más necesita un sistema multiagente además del chat?
Tres funciones convierten a Relay de sala de chat en herramienta de orquestación.
- Acciones. Registras una función tipada con un esquema Zod y todos los agentes la ven como herramienta MCP. El README trae dos ejemplos: una acción
spawn-claudepara que un agente lance a otro, y una acciónsubmit-votepara que un equipo de agentes llegue a una decisión estructurada. Las acciones son fire-and-forget: el agente recibe un acuse y el resultado llega como eventoaction.completed. - Listeners de eventos. Reaccionas a cambios de estado desde tu código. Por ejemplo: cuando el agente ingeniero pasa a
idle, publicar en#generalque está libre para la siguiente tarea. - Webhooks. Los webhooks entrantes convierten eventos de GitHub Actions, Sentry o Prometheus en mensajes de canal. Los salientes envían eventos de Relay a tus servicios con firma HMAC.
¿Agent Relay funciona en local o en la nube?
En ambos. El broker que ejecuta tus agentes es local, pero el hub de mensajería está alojado por el proyecto. La documentación de arquitectura ubica el motor en cast.agentrelay.com y aclara que no existe uno local. Al 25 de octubre de 2026, la documentación no describía ninguna forma de autoalojar ese motor. Los mensajes de tus agentes pasan por el servicio de Agent Relay, así que tenlo en cuenta antes de poner código interno o credenciales en un canal.
La introducción indica que no necesitas una API key para crear un workspace. Al momento de publicar esta nota, las páginas que consultamos no publicaban precios del servicio alojado.
La telemetría viene activada por defecto. Según TELEMETRY.md, el CLI envía eventos de uso con un ID de máquina anónimo y hasheado. Si inicias sesión con agent-relay cloud login, también adjunta los IDs de tu cuenta y tu organización. El proyecto afirma que no recolecta el contenido de los mensajes, nombres de archivos ni secretos. Para desactivarla:
agent-relay telemetry disable
También puedes usar DO_NOT_TRACK=1 o AGENT_RELAY_TELEMETRY_DISABLED=1. El comando agent-relay telemetry status muestra qué se está atribuyendo y a quién.
¿Agent Relay funciona en Windows?
No de forma nativa para el runtime local. Desde la versión 12.1.0, node up se niega a arrancar fuera de macOS y Linux. WSL cuenta como Linux, así que en Windows el camino es correrlo dentro de WSL.
¿Agent Relay o Paperclip AI?
Resuelven capas distintas, y puedes usar ambos. Paperclip AI modela una organización: roles, un tablero de tareas, presupuestos por agente y aprobaciones, y lo alojas tú. Agent Relay es el cable que va por debajo: quién puede escribirle a quién y cómo ese mensaje llega de forma confiable a una sesión activa.
Si tu problema es “mis agentes no pueden hablar entre sí”, Relay es la solución más chica y directa. Si tu problema es “veinte agentes gastan dinero y nadie sabe quién hace qué”, necesitas la capa de gestión.
También es distinto de Claude Code Channels, que te permite a ti escribirle a una sesión de Claude Code desde Telegram o Discord. Relay es de agente a agente, entre proveedores distintos. Y si todavía estás eligiendo con cuál trabajar, nuestra comparativa Claude Code vs Codex explica cómo correr los dos con tus propias claves.
¿Y tú? ¿Cómo coordinas hoy el trabajo cuando tienes más de un agente de IA abierto a la vez?
- Copio y pego entre terminales
- Uso los subagentes de Claude Code
- Uso un orquestador como Paperclip
- Prefiero otra opción (cuéntanos cuál)
Comenta abajo o, si este artículo te llegó por correo, responde directamente al email: tu respuesta se publica aquí.
Relacionado: Paperclip AI: qué es y cómo orquestar Claude Code, Codex y Cursor como un solo equipo