Agent Relay

Agent Relay

[](https://github.com/Oussamoux1234/agent-relay/actions/workflows/ci.yml) [](LICENSE)

Agent Relay is a local-first continuity layer for AI coding agents. It saves an explicit task checkpoint and hands that checkpoint to another user-owned runtime, such as a CLI agent, local script, or future API adapter.

The MVP answers one question: **can a user register arbitrary agents and move a task between them without losing verified work state or blindly repeating uncertain actions?**

What works now

• Register any local executable as an agent adapter.
• Register reviewed presets for Codex CLI, Claude Code, Gemini CLI, and Antigravity CLI.
• Describe its fixed arguments, prompt transport, capabilities, timeout, and permitted environment-variable names.
• Create a versioned, inspectable task checkpoint.
• Record summaries, decisions, constraints, changed files, tests, and next steps.
• Preview the exact prompt before a handoff.
• Execute a handoff without invoking a shell.
• Record every handoff as pending before the target process starts.
• Mark manual-handoff timeouts and non-zero exits as unknown and block further handoffs until the user resolves the outcome.
• Configure an ordered route across Codex, Claude, Gemini, and Antigravity preset instances.
• Continue to the next read-only agent after a documented quota/rate-limit signal or a process that could not start.
• Fail closed on authentication, timeout, overload, and unrecognized routed failures.
• Persist local state atomically with owner-only permissions where the filesystem supports them.

Agent Relay does not claim to transfer a model's hidden reasoning or private session. It transfers an auditable set of facts about the task.

Architecture

                                  ┌─ Codex CLI adapter
User ──> Relay service