Code Relay

Runbooks com escopo de branch, checkpoints remotos e recibos de verificação auditáveis.

Documentação

Code Relay

Construa. Prove. Retransmita.

O Code Relay permite que seu agente de codificação desenvolva em uma máquina e comprove o resultado em outra.

Relay é uma integração de agente de codificação baseada em MCP para desenvolvimento e verificação entre máquinas. A IA no Host de Desenvolvimento implementa a solicitação; o Host de Destino executa a validação real; um recibo estruturado retorna para orientar a próxima iteração de reparo. Funciona com Codex, Claude Code, Cursor, VS Code e outros agentes de codificação compatíveis com MCP.

Quando o Relay é útil

Ambientes diferentes — desenvolva no Windows ou macOS, verifique no Linux, em uma rede privada ou em um host semelhante ao de produção.
Hardware especial — envie código de modelo para uma máquina CUDA/GPU, ou verifique uma câmera, dispositivo serial ou sensor onde ele está conectado.
Integrações reais — exercite callbacks de pagamento, filas, bancos de dados, navegadores ou serviços internos que não podem ser reproduzidos localmente.
Iteração orientada por IA — retorne resultados concretos de esperado/real para que o agente de codificação possa reparar, republicar e tentar novamente.

O que o Relay oferece

Vinculação de projeto com escopo de branch e links de entrada de curta duração.
Verificação exata do commit de origem em uma árvore de trabalho isolada.
Execução de checkpoint por meio de um code-relay-checkpoint runner auto-hospedado do GitHub Actions.
Comandos de validação seguros e na lista de permissões, com saída limitada e timeouts.
receipt.json estruturados e recibos legíveis para execuções aprovadas, reprovadas e bloqueadas.

Início rápido

Instalação do cliente de IA

Deixe seu agente de codificação ler e seguir as instruções:

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

Alternativa via npm

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

Substitua codex por claude-code, cursor, vscode ou generic conforme necessário.

Detalhes do servidor MCP

Code Relay é um servidor MCP local que se comunica via stdio. O pacote npm inicia o servidor com:

npx -y code-relay-mcp@3.1.0

O servidor implementa a superfície JSON-RPC do MCP diretamente em Go (sem um SDK MCP de terceiros). Ele suporta initialize, ping, tools/list e tools/call, e expõe estas ferramentas:

Ferramenta	Finalidade
`bind_project`	Vincular um repositório e branch a um papel de relay.
`create_checkpoint_invite`	Criar um link de entrada de checkpoint de curta duração.
`join_checkpoint`	Entrar em uma assinatura de checkpoint com escopo de branch.
`watcher_status`	Ler o estado local do watcher.
`stop_watcher`	Parar o watcher local.
`doctor`	Executar verificações de saúde locais não mutáveis.
`publish_runbook`	Validar e publicar um runbook.
`status`	Ler o status do runbook e do recibo.
`fetch_receipt`	Carregar e validar um recibo de runbook.
`analyze`	Analisar um recibo e determinar o próximo estado.

A implementação e o loop de transporte estão em internal/relay/mcp.go.

Como 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

o Host de Desenvolvimento envia um runbook vinculado a repositório e branch através do Relay; o Host de Destino verifica o commit de origem exato em seu ambiente real e retorna um Recibo registrando o resultado do Checkpoint.

Todo runbook é vinculado a um repositório, branch e commit de origem. O Host de Destino atua como o Checkpoint, e o recibo resultante registra a verificação aprovada, reprovada ou bloqueada para a próxima iteração.

Documentação

Licença

Code Relay é distribuído sob a Licença MIT.