Agent Relay

Changelog

Release notes for Agent Relay. Format follows Keep a Changelog and the project follows Semantic Versioning. Downloadable artifacts live on the GitHub Releases page.

  1. v0.7.0

    View release →
    • Interactive REPL (relay with no subcommand). Persistent slash shell modeled on Claude Code / Codex: every existing CLI command is also a /-prefixed slash command, bare text is forwarded to the active agent's PTY, and the inline Textual panel redraws on every keystroke. Driven by a single SlashRegistry so /help, the slash menu, and docs/repl.md never drift.
    • Tmux integration. relay --tmux wraps the REPL in relay-<sha256(cwd)[:8]> for crash-safety; relay --attach reattaches. /tmux status|detach|split <agent> from inside the REPL. First-run prompt persists the choice to tmux_auto in config.toml.
    • Structured JSONL logging at ~/.config/relay/repl.log (rotating 5×1 MB). Captures session lifecycle, slash dispatch (cmd / duration_ms / ok / error), agent spawn/exit, signal events. RELAY_LOG_LEVEL honored.
    • **/diagnose** — shareable bundle (version + redacted log tail) for bug reports.
    • Crash recovery — pidfile reaper at startup. PID files live in ~/.config/relay/agents/; on next launch we cross-check the live command line against the recorded agent and only signal genuine orphans. Reused PIDs are skipped silently.
    • Onboarding wizard on first run (config file missing). Detects agents, picks a default, asks about tmux, persists to config.toml. Re-runnable via /setup. --no-onboarding skips it for CI/scripts.
    • **[repl.env] config section** for opting in additional env forwards to spawned agents. Keys validated as proper env-variable names; values still scrubbed by the deny-list unless on the per-agent provider allowlist.
    • Performance budgets + gated micro-benches in tests/bench_repl.py (RELAY_BENCH=1). 16 ms p99 keystroke-to-render target documented in docs/performance.md.
    • Auto-generated slash-command reference (docs/repl.md) plus a CI gate (tests/test_repl_docs.py) that fails the build if the registry and the doc drift.
    • New docs: docs/repl.md, docs/architecture.md, docs/performance.md, docs/security.md (env contract + redaction pipeline + validation rules).
    • scripts/release.sh X.Y.Z — one-command release prep. Bumps __version__, the extension package.json, regenerates the lockfile, rewrites CHANGELOG.md's [Unreleased] header to a dated [X.Y.Z], regenerates the docs-site changelog + search-index JSON, and stages everything for a PR. Doesn't commit/push/tag — leaves that to the user's branch workflow.
    • Hook-based automatic rate-limit handoff. relay install now wires Claude Code Notification and Codex Stop hooks, normalizes hook payloads into daemon rate_limited events, and lets live REPL sessions execute a matching automatic handoff through the configured fallback order.
    • Install-time fallback-order setup. relay install infers [handoff].order from detected Claude, Codex, and Gemini CLIs when no order exists. Use relay install --handoff-order ... to override or --no-handoff-order to skip.
    • Per-agent env allowlist. build_agent_env now takes an agent= parameter and only forwards a provider key (e.g. ANTHROPIC_API_KEY) when launching that agent. All other forwarded keys whose values match a known-secret prefix (sk-, AKIA, ghp_, xox, …) are replaced with [REDACTED] before reaching the child.
    • Slash parser hardening. Every string / list-of-string argument passes through validate_string (rejects null bytes and control chars outside \t\n\r); ArgSpec.choices is now enforced; paths go through resolve_safe_path (rejects .. traversal, absolute, ~, and symlink escapes unless --allow-outside-cwd).
    • **Docs now treat relay as the primary workflow.** README, web docs, public concept pages, and examples were updated around the interactive shell, repo-local session lineage, automatic handoff triggers, and the current command surfaces.
    • **logger.exception(...) no longer leaks secrets to disk.** _JsonlFormatter.format now runs redact() over exc_info, pre-cached exc_text, and stack_info — the last hop before the JSONL file. Previously the redaction filter only touched the message and structured extras, so a traceback containing key=sk-… survived to disk.
    • **/diagnose --json no longer leaks the working directory path.** The JSON payload's cwd field now goes through the same redact() call the text path uses, so output is safe to paste into a bug report from any project.
    • Docs-site changelog page now renders **bold** markdown properly (was showing literal ** characters in the v0.6.x entries).

  2. v0.6.3

    View release →
    • Homebrew bump PR: git push from the rendered formula failed because gh repo clone authenticates via GH_TOKEN but git push falls back to the git credential helper which has no credentials in CI. Now we rewrite the tap remote URL to embed the PAT (https://x-access-token:$GH_TOKEN@github.com/…) right after clone so subsequent pushes succeed without any extra credential helper setup.

  3. v0.6.2

    View release →
    • VS Code extension publish is no longer automated. The Marketplace publisher Members / Azure DevOps identity dance proved brittle in CI; publishing the .vsix by hand from a laptop is a five-minute step per release and avoids surprises. The recipe lives as a comment in release.yml. The extension's package.json now tracks the main package version (0.6.2 here) so manual publishes stay in step.
    • Homebrew bump PR. The release workflow tried to cp the rendered formula into tap/Formula/agent-relay.rb, but a freshly-created tap repo doesn't have a Formula/ directory yet. Added mkdir -p tap/Formula before the copy.

  4. v0.6.1

    View release →
    • Intel macOS native binary (relay-darwin-x64). GitHub deprecated the macos-13 runner in 2026 and capacity collapsed — jobs targeting that label routinely queue for hours without starting. Intel-Mac users now fall through automatically to install.sh's uv tool install fallback; the curl one-liner still works on Intel Macs, it just takes the source path instead of a binary download. Apple Silicon, Linux x64, Linux arm64, and Windows x64 binaries are unaffected. Revisit when (if) we need cross-compile-from-arm64 to bring back the native binary.
    • The v0.6.0 release shipped without the Homebrew bump PR (the bump-homebrew job depended on the cancelled darwin-x64 matrix entry). With darwin-x64 dropped from the matrix, v0.6.1 produces a clean Homebrew bump PR automatically, so brew install bethvourc/tap/agent-relay now works.

  5. v0.6.0

    View release →
    • Always-on layer: a small local daemon plus four adapters captures context from every AI coding agent on the machine and hands off automatically when one rate-limits. Drive it from the CLI, or let it run in the background. See the always-on guide.
    • relay install / uninstall / doctor — detects installed agents (Claude Code, Cursor, Antigravity, Windsurf, VS Code, Codex CLI, aider, Gemini CLI, Warp), wires hooks/extensions/configs, and registers the daemon for auto-start via launchd / systemd user units / Windows Startup folder. doctor runs six health checks.
    • relay daemon start|stop|status|tail — manages the background process; tail streams live events from every adapter.
    • relay wrap <cmd> — PTY-wraps any CLI agent (codex, aider, gemini-cli, sgpt, llm) so its rate-limits and lifecycle are captured without disturbing colours, prompts, or ^C.
    • relay resume <snapshot-id> + relay snapshots — list and reopen handoff snapshots produced by the daemon.
    • relay dashboard — local web UI showing live sessions, snapshots, and a handoff trigger. Built into the binary; no external service.
    • relay proxy start|status|cert — opt-in HTTPS proxy (requires pip install agent-relay-tool[proxy]) for lossless rate-limit capture from Anthropic / OpenAI / Google response headers.
    • relay mcp serve — MCP server that lets Warp's native agent (or any MCP-aware client) feed events into the relay log.
    • relay self-update — pulls the latest binary release and replaces the running executable atomically.
    • relay short command — declared alongside agent-relay in the PyPI package, so the canonical short name works regardless of install method.
    • --version / -V flag on the root parser.
    • VS Code-family extension — one extension published to Open VSX and the VS Code Marketplace covers Cursor, Antigravity, VS Code, Windsurf, Trae, Void, and any future VS Code fork. Includes a Relay: Hand off this session command on Cmd+Shift+R.
    • Native binary distribution — PyInstaller bundles for macOS arm64 / macOS x64 / Linux x64 / Linux arm64 / Windows x64, published on every release via GitHub Actions. The curl one-liner at agent-relay.dev now detects platform and pulls the right binary, with a uv tool fallback.
    • Homebrew tap at bethvourc/homebrew-tap — brew install bethvourc/tap/agent-relay installs the native binary.
    • Docs site: new pages at /always-on, /architecture, /privacy, /adapters/{claude-code,cursor,warp,cli}.
    • pyproject.toml cleaned up — [project.optional-dependencies] was previously nested inside [project], which silently dropped authors / keywords / classifiers under the wrong section.
    • Release pipeline split: publish.yml keeps PyPI ownership; release.yml owns platform binaries (uploaded to the public mirror via a scoped PAT), VS Code extension publishing, and the Homebrew bump PR. Source code stays on the private origin; only compiled artifacts surface publicly.

  6. v0.5.6

    View release →
    • deactivate command (alias complete) for marking a session as finished or inactive, giving you explicit control over session lifecycle instead of relying on implicit timeouts.
    • Console feedback when a session is deactivated, so it's clear which session closed and what its final state was.
    • Public community mirror at github.com/bethvourc/agent--relay for README, issues, discussions, and releases. Source remains private.
    • Project metadata (pyproject.toml Homepage/Source/Issues) now points at the public mirror, so PyPI sidebar links resolve for anonymous visitors.
    • Docs site (agent-relay.dev) GitHub/issue links route to the public mirror.
    • Installation scripts (install.sh, install.ps1) refined for clearer platform-specific guidance.

  7. v0.5.5

    View release →
    • Improved cost estimation and model handling in metrics + CLI; cost labels in the dashboard and alerts now read as "est. cost" to make clear that values are estimates rather than billed amounts.
    • Last release before the public-mirror split.

  8. v0.5.0

    View release →
    • alerts command for inspecting threshold breaches across sessions, with matching dashboard panel that integrates alerts into the session detail view.
    • Live-update controls for the dashboard: opt-in soft-refresh with JSON payloads so the page can update in place without a full reload.
    • MetricsFilter for scoped metric queries — filter dashboard views by session, agent, time window, and more.
    • HTML dashboard surface for the Prometheus exporter so operators get a browsable view alongside the scrape endpoint.
    • Chart features on the dashboard for session metrics (token, cost, and latency over turns).
    • PyPI download badge on the README for visibility into install volume.
    • Standardised metric labels and heading styles across the UI for a more consistent look.
    • Refactored UI colour themes to use a token-based styling system; surface rule applied consistently to metrics panels and other surfaces.
    • Help command structure reworked for clearer navigation and grouping.
    • Turn-status aliases introduced so metrics and watch output read more naturally.
    • Deprecated CLI and integration test files cleaned out as part of the metrics refactor.

  9. v0.4.0

    View release →
    • watch command — live session monitoring that follows an in-progress session and auto-picks the latest active session when none is given. Includes a --metrics panel that refreshes per turn.
    • metrics command for token / cost / latency rollups per session.
    • metrics-tail command streams metric events as JSONL for ingestion into external pipelines.
    • metrics-serve command exposes Prometheus and OTLP exporters from the local daemon, with alert evaluation hooks emitted into the JSONL stream.
    • Fallback logic in watch improved so the command picks the latest session when no id is supplied, instead of erroring out.

  10. v0.3.0

    View release →
    • Gemini agent adapter — Agent Relay now drives Gemini alongside Claude and Codex.
    • Turn prompt logic refined to conditionally display the preamble, improving conversation flow when context is already loaded.
    • Session snapshot rendering in handoffs cleaned up for a tighter output.

  11. v0.2.0

    View release →
    • converse command for agent-to-agent turn-based interaction.
    • discover command for detecting available agent CLIs on the host.
    • clean command for removing all relay sessions.
    • resolve command for resolving conflicts in concurrent agent runs, including capture-hook specifications and claim handling.
    • Concurrent execution support with tmux session management and pane capture; phase management and control status reporting for multi-agent workflows.
    • Agent aliases and tmux integration so existing tmux users can plug Agent Relay into their workflow.
    • Verbose output option on the claude command.
    • Renamed PyPI package from agent-relay to agent-relay-tool to clear up naming conflicts; installation instructions updated to match.
    • Codex output normalisation: trailing "done" markers stripped so handoff payloads don't carry noise.
    • Conversation rendering in the CLI extended to include agent output inline.
    • Workstream kind defaults to mixed in concurrent execution; schema validation added.

  12. v0.1.0

    View release →
    • Initial release. Agent Relay ships as a local-first CLI for handing off coding sessions between AI agents.
    • agent-relay <agent> — the one command that captures the current session state, generates a handoff packet, and launches the next agent with context preserved.
    • v2 session model: per-repo storage at <repo>/.agent-relay/ with manifests, journals, checkpoints, and content-addressed objects.
    • repair command for fixing inconsistencies in v2 sessions, plus integrity checks on session load.
    • Lifecycle management (active / completed / archived) with safety checks on launch commands and agent profiles.
    • Status / dashboard rendering for inspecting sessions from the CLI.
    • Migration path from legacy session files into v2 sessions.