FAQ
The questions that come up most often. If yours isn't here, open an issue on GitHub.
Where is my data stored?
Locally, in a .agent-relay/ directory inside the repo you ran the CLI
from. Sessions, checkpoints, turn artifacts, and metrics all live on
disk. Nothing is uploaded. See Sessions for the
full on-disk layout.
Does Agent Relay send my code anywhere?
No. Agent Relay itself makes no network calls. The underlying agents (Claude Code, Codex) talk to their respective providers exactly as they would without Agent Relay — Agent Relay only captures and replays what those agents emit.
Which agents are supported?
Built-in adapters ship for claude-code (alias c) and codex (alias
x). Run agent-relay discover to see what's available
in your environment. New adapters can be added via the public adapter
contract — open an issue if you'd like one we don't ship yet.
Why a Python CLI?
Most developers using coding agents already have Python on their
machine, and the Python ecosystem has the cleanest tooling for shipping
a tightly-scoped CLI — namely uv tool install and pipx, both of
which install Agent Relay into its own isolated environment.
What about Windows?
Native Windows is supported via the install.ps1 PowerShell installer
— see Installation. WSL works too: if you're inside
WSL, treat it as Linux and use install.sh.
How do I uninstall?
Whichever installer you used has a matching removal — see the
Uninstalling section on the install page.
To clear local session data, also delete .agent-relay/ from any repo
you used it in.
Is there a config file?
Yes — optional, repo-scoped. See Configuration for the available keys and how environment variables override them.
Can I run multiple agents in parallel?
Yes — that's exactly what Multi-agent race is for. Two or more agents run in isolated git worktrees against the same task; you pick the winner and Agent Relay routes the accepted changes back to your branch.
What happens if an agent crashes mid-task?
Every turn writes its artifacts to disk before the next turn starts, so a crash only loses the in-flight turn (which hadn't been confirmed anyway). Resuming a session walks through the recovery flow.
What's the license?
Apache-2.0. The full source lives at github.com/bethvourc/agent-relay.