Code Relay

Runbooks por rama, puntos de control remotos y recibos de verificación auditables.

Documentación

Code Relay

Construye. Demuestra. Transmite.

Code Relay permite que tu agente de codificación desarrolle en una máquina y demuestre el resultado en otra.

Relay es una integración de agente de codificación basada en MCP para desarrollo y verificación entre máquinas. La IA en el Host de Desarrollo implementa la solicitud; el Host de Destino ejecuta la validación real; un recibo estructurado regresa para guiar la siguiente iteración de reparación. Funciona con Codex, Claude Code, Cursor, VS Code y otros agentes de codificación compatibles con MCP.

Cuándo es útil Relay

Entornos diferentes — desarrolla en Windows o macOS, verifica en Linux, una red privada o un host similar al de producción.
Hardware especial — envía código de modelo a una máquina CUDA/GPU, o verifica una cámara, dispositivo serial o sensor donde esté conectado.
Integraciones reales — ejercita callbacks de pago, colas, bases de datos, navegadores o servicios internos que no se pueden reproducir localmente.
Iteración impulsada por IA — devuelve resultados concretos esperados/actuales para que el agente de codificación pueda reparar, republicar y reintentar.

Qué proporciona Relay

Vinculación de proyecto por rama y enlaces de unión de corta duración.
Verificación exacta del commit fuente en un árbol de trabajo aislado.
Ejecución de puntos de control a través de un code-relay-checkpoint ejecutor autoalojado de GitHub Actions.
Comandos de validación seguros y en lista blanca con salida limitada y tiempos de espera.
receipt.json estructurados y recibos legibles para ejecuciones aprobadas, fallidas y bloqueadas.

Inicio rápido

Instalación del cliente de IA

Deja que tu agente de codificación lea y siga las instrucciones:

https://raw.githubusercontent.com/zarcherlot/code-relay/main/install.md

Alternativa con npm

npx -y code-relay-mcp@latest install --client codex

Reemplaza codex con claude-code, cursor, vscode o generic según sea necesario.

Detalles del servidor MCP

Code Relay es un servidor MCP local que se comunica a través de stdio. El paquete npm inicia el servidor con:

npx -y code-relay-mcp@3.1.0

El servidor implementa la superficie JSON-RPC de MCP directamente en Go (sin un SDK MCP de terceros). Soporta initialize, ping, tools/list y tools/call, y expone estas herramientas:

Herramienta	Propósito
`bind_project`	Vincula un repositorio y una rama a un rol de relay.
`create_checkpoint_invite`	Crea un enlace de unión de punto de control de corta duración.
`join_checkpoint`	Únete a una suscripción de punto de control por rama.
`watcher_status`	Lee el estado local del observador.
`stop_watcher`	Detén el observador local.
`doctor`	Ejecuta comprobaciones de salud locales no mutantes.
`publish_runbook`	Valida y publica un runbook.
`status`	Lee el estado del runbook y del recibo.
`fetch_receipt`	Carga y valida un recibo de runbook.
`analyze`	Analiza un recibo y determina el siguiente estado.

La implementación y el bucle de transporte están en internal/relay/mcp.go.

Cómo funciona

Dev Host sends a runbook through Code Relay to a Target Host; the Target Host runs a checkpoint and returns a receipt with evidence

el Host de Desarrollo envía un runbook vinculado a un repositorio y una rama a través de Relay; el Host de Destino verifica el commit fuente exacto en su entorno real y devuelve un Recibo que registra el resultado del Punto de Control.

Cada runbook está vinculado a un repositorio, una rama y un commit fuente. El Host de Destino actúa como el Punto de Control, y el recibo resultante registra la verificación aprobada, fallida o bloqueada para la siguiente iteración.

Documentación

Licencia

Code Relay se publica bajo la Licencia MIT.