Relayvora

Relayvora

Relayvora is a powerful tool designed to streamline the way unfinished work is handed off between AI agents, specifically Claude Code and Codex. Instead of laboriously copying lengthy session transcripts, Relayvora enables quick, verified handoffs, saving both time and resources.

Key Features

• Efficient Handoffs: Relayvora rapidly transfers ongoing projects from one AI agent to another using a concise and verified handoff protocol.
• Session Insights: The tool analyzes the current session, summarizing goals, recent requests, and agent reports.
• Ground Truth Verification: It checks for uncommitted changes, commits made during the session, and collects real test results to ensure accuracy.
• Fact Labelling: Each piece of information is tagged as [observed], [user], [agent-reported], or [inferred], aiding the next agent's understanding of the context.
• Lightweight Usage: Operates locally on multiple platforms including Windows, macOS, and Linux, with no telemetry involved, prioritizing user privacy.

Example of Use

Relayvora is simple to use. The following command enables a seamless handoff between Codex and Claude Code, ensuring that the new agent is fully briefed on the current session:

relayvora handoff --from codex --to claude --verify auto --confirm

The Process

1. Read the session: Gather the latest requests and the agent's last report from the session transcript.
2. Capture evidence: Identify and record changes made during the session, while keeping sensitive information secure.
3. Verify the results: Automatically runs project-specific checks to validate the outcomes.
4. Construct the handoff: All relevant information is consolidated into a token-efficient summary that highlights important elements.
5. Launch the new agent: Initiate the desired agent with the briefed information.
6. Measure and report: Users can evaluate the effectiveness of the relay process and its impact on session performance.

Performance Insights

Relayvora optimizes the use of tokens and context, particularly in large sessions where efficiency translates into significant cost savings over multiple calls. Performance metrics indicate that while it may not save money in smaller sessions, it excels in large environments where context management is crucial, providing reductions in input tokens by up to 60%.

Command Overview

Here are a few essential commands for interaction with Relayvora:

• relayvora – Displays the home screen with project stats and suggestions.
• relayvora doctor – Checks the necessary requirements and setup status.
• relayvora watch – Monitors agent usage limits and alerts when a relay is advisable.

Privacy and Data Security

Relayvora emphasizes user privacy, being completely local without any data being uploaded or telemetry collected. Checkpoint retention is configurable, assuring users maintain control over their data.

Relayvora represents a significant innovation for developers using AI-based coding assistants, enabling more seamless workflows and efficient project management in complex coding environments.