Relay: Transfira Sessões 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.

📖 Read the full source: r/ClaudeAI