Agent Session Relay

Agent Session Relay

`relay` browses local coding-agent histories, shares applicable skills, and resumes a selected session with Codex, Grok, Claude Code, Antigravity CLI (`agy`), or a compatible custom target. It never requires the source agent to prepare a handoff.

The current MVP was built and tested against:

• Codex CLI 0.149.0
• Grok Build 1.0.4
• Claude Code 2.1.220
• Antigravity CLI (agy) 1.1.20
• Python 3.12 (Python 3.10 or newer is supported)

It has no third-party Python dependencies.

Agent Session Relay is an independent, unofficial project and is not affiliated with OpenAI, xAI, Anthropic, or Google. CLI history formats are vendor-controlled and may change; version compatibility is tested rather than guaranteed.

Install

With `pipx`:

pipx install git+https://github.com/tomzhu0225/agent-session-relay.git

With `uv`:

uv tool install git+https://github.com/tomzhu0225/agent-session-relay.git

Or from a checkout:

git clone https://github.com/tomzhu0225/agent-session-relay.git
cd agent-session-relay
python3 -m pip install --user .

Relay is currently intended for POSIX environments, including Linux, WSL, and macOS. Python 3.10 or newer is required.

Quick start

relay setup
relay skills sync
relay agents
cd /path/to/project
relay sessions
relay resume

The setup is deliberately small enough to do manually. On a machine with several agents, custom homes, or existing skill collections, using a coding agent to inspect and configure Relay is convenient. See [Agent-assisted setup](docs/agent-assisted-setup.md) for a bounded prompt that does not let the installer modify histories or overwrite skill conflicts.

`relay resume` lists sessions for the current Git worktree, newest first. Its `Last agent` column distinguishes standard Codex (`codex-native`) from configured wrappers such as `codex-glm`. Relay uses the latest provider metadata in Codex history and retains the selected target for native resumes