Relay: Uma Ferramenta para Transferir Sessões de Código do Claude para Outros Agentes de IA

Relay é uma ferramenta que resolve um problema comum para usuários do Claude Code: quando uma sessão atinge seu limite de taxa, todo o contexto é perdido, forçando os usuários a reiniciar com outro agente. O Relay captura o contexto da sessão e o transfere para um agente de IA diferente, permitindo que o trabalho continue sem interrupções.

Como Funciona

Relay é um binário Rust (4.6 MB) que lê as transcrições da sessão do Claude Code diretamente dos arquivos JSONL em ~/.claude/projects/. Ele extrai:

• A conversa completa (últimas 25 interações por padrão)
• Todas as chamadas de ferramentas — arquivos que o Claude leu, escreveu ou editou
• Todos os erros que o Claude encontrou
• Estado do TodoWrite (o que foi feito e o que está em andamento)
• Branch do git, diff e arquivos não commitados
• Decisões importantes que o Claude tomou

Em seguida, ele abre uma sessão interativa com o novo agente, que reconhece o contexto restaurado e pergunta sobre os próximos passos.

Uso e Recursos

O comando básico é:

relay handoff --to codex

Opções adicionais incluem:

• --turns 10 para controlar quanto contexto da conversa é transferido
• --include git,todos para selecionar elementos específicos do contexto
• Um gancho PostToolUse para detecção automática de limites de taxa

O Relay inclui uma TUI interativa com spinners, um seletor de agentes e saída colorida. O tempo de captura é inferior a 100ms.

Agentes Suportados

O Relay suporta 8 agentes:

• Codex
• Claude (nova sessão)
• Aider
• Gemini
• GitHub Copilot
• OpenCode
• Ollama (local)
• OpenAI API

Instalação

Instale via:

git clone https://github.com/Manavarya09/relay
cd relay && ./scripts/build.sh
ln -sf $(pwd)/core/target/release/relay ~/.cargo/bin/relay
relay init

Ou via npm: npm i @masyv/relay

Contexto

O Relay é o quarto plugin no kit de ferramentas do Claude Code do autor, que também inclui TokenForge (para compressão de tokens via análise AST) e SecretScan (um detector de segredos com 47 padrões). Todas as ferramentas são de código aberto e escritas em Rust.