Relay: Ein Tool zur Übergabe von Claude-Code-Sitzungen an andere KI-Agenten

Relay ist ein Tool, das ein häufiges Problem für Claude Code-Nutzer löst: Wenn eine Sitzung ihr Ratenlimit erreicht, geht der gesamte Kontext verloren, sodass Nutzer mit einem anderen Agenten neu starten müssen. Relay erfasst den Sitzungskontext und übergibt ihn an einen anderen KI-Agenten, sodass die Arbeit ohne Unterbrechung fortgesetzt werden kann.

Wie es funktioniert

Relay ist ein Rust-Binary (4,6 MB), das die Sitzungstranskripte von Claude Code direkt aus den ~/.claude/projects/ JSONL-Dateien liest. Es extrahiert:

• Das vollständige Gespräch (standardmäßig die letzten 25 Wechsel)
• Jeden Tool-Aufruf – Dateien, die Claude gelesen, geschrieben oder bearbeitet hat
• Jeden Fehler, auf den Claude gestoßen ist
• TodoWrite-Status (was erledigt ist und in Arbeit)
• Git-Branch, Diff und unbestätigte Dateien
• Wichtige Entscheidungen, die Claude getroffen hat

Es startet dann eine interaktive Sitzung mit dem neuen Agenten, der den wiederhergestellten Kontext bestätigt und nach den nächsten Schritten fragt.

Verwendung und Funktionen

Der grundlegende Befehl lautet:

relay handoff --to codex

Zusätzliche Optionen umfassen:

• --turns 10 zur Steuerung, wie viel Gesprächskontext übertragen wird
• --include git,todos zur Auswahl spezifischer Kontextelemente
• Einen PostToolUse-Hook zur automatischen Erkennung von Ratenlimits

Relay enthält eine interaktive TUI mit Ladesymbolen, einem Agenten-Auswahlmenü und farbcodierter Ausgabe. Die Erfassungszeit liegt unter 100 ms.

Unterstützte Agenten

Relay unterstützt 8 Agenten:

• Codex
• Claude (neue Sitzung)
• Aider
• Gemini
• GitHub Copilot
• OpenCode
• Ollama (lokal)
• OpenAI API

Installation

Installation über:

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

Oder über npm: npm i @masyv/relay

Kontext

Relay ist das vierte Plugin im Claude Code-Toolkit des Autors, das auch TokenForge (für Token-Kompression via AST-Parsing) und SecretScan (ein 47-Muster-Geheimnis-Detektor) umfasst. Alle Tools sind Open Source und in Rust geschrieben.