Relay: A Tool for Handing Off Claude Code Sessions to Other AI Agents

Relay is a tool that addresses a common issue for Claude Code users: when a session hits its rate limit, the entire context is lost, forcing users to restart with another agent. Relay captures the session context and hands it off to a different AI agent, allowing work to continue without interruption.

How It Works

Relay is a Rust binary (4.6 MB) that reads Claude Code's session transcripts directly from ~/.claude/projects/ JSONL files. It extracts:

• The full conversation (last 25 turns by default)
• Every tool call—files Claude read, wrote, or edited
• Every error Claude encountered
• TodoWrite state (what's done and in progress)
• Git branch, diff, and uncommitted files
• Key decisions Claude made

It then opens an interactive session with the new agent, which acknowledges the restored context and asks for next steps.

Usage and Features

The basic command is:

relay handoff --to codex

Additional options include:

• --turns 10 to control how much conversation context is transferred
• --include git,todos to select specific context elements
• A PostToolUse hook for automatic detection of rate limits

Relay includes an interactive TUI with spinners, an agent picker, and color-coded output. Capture time is under 100ms.

Supported Agents

Relay supports 8 agents:

• Codex
• Claude (new session)
• Aider
• Gemini
• GitHub Copilot
• OpenCode
• Ollama (local)
• OpenAI API

Installation

Install 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

Or via npm: npm i @masyv/relay

Context

Relay is the fourth plugin in the author's Claude Code toolkit, which also includes TokenForge (for token compression via AST parsing) and SecretScan (a 47-pattern secret detector). All tools are open source and written in Rust.