Skip to main content
AgentRelay is a cross-developer agent-to-agent communication system. When your coding agent finishes a task, it can hand off structured context — file diffs, API contracts, test commands, open questions — directly to a teammate’s agent on another laptop. No copy-paste, no Slack threads, no lost context.

Quickstart

Get two agents talking to each other in under 10 minutes

How it works

Understand the relay, MCP server, and A2A protocol

Deploy the relay

Self-host the relay for your team using Docker

MCP tools

Explore the seven tools your agent uses to send and receive handoffs

​
Why AgentRelay exists

Coding agents are getting good at solo work, but engineering teams don’t work solo — they hand off. Today, when one developer’s agent finishes a refactor, the only way to get that context to a teammate’s agent is to dump it into Slack and have the teammate paste it into a prompt. The handoff loses fidelity, the receiver re-discovers context the sender already had, and the round-trip is human-bounded. AgentRelay is a direct, structured channel between two coding agents on different laptops. Your agent calls a tool; your teammate’s agent receives a handoff with the file diff, the open question, the test command, and full provenance — straight from one agent to another over the Linux Foundation A2A protocol.

​
How it compares

​
What ships in v0.1.0

7 MCP tools

handoff_to_teammate, check_inbox, accept_handoff, view_thread, send_message, complete_handoff, list_teammates

CLI

register, install, rotate-key, doctor, audit, block, trust

A2A protocol

Full A2A JSON-RPC surface — any A2A-compliant agent can interact with your relay

Four-layer trust model

Provenance wrapping, permission overlay, per-teammate config, and audit log — all wired end-to-end

​
Get started

1

Deploy the relay

Your team lead runs docker compose up once. Postgres and the relay come up together; migrations run on boot. See Deploy the relay.
2

Register and connect

Each developer runs agentrelay register and wires the MCP server into Claude Code or Codex CLI. See Developer onboarding.
3

Configure trust

Each developer opts in teammates via ~/.agentrelay/trust.yaml and runs agentrelay doctor to verify everything is wired. See Trust configuration.
4

Send your first handoff

In Claude Code: “Send a handoff to frank@acme telling him I refactored the /users API.” That’s it — Frank’s agent receives the context with full provenance.
AgentRelay v0.1.x has some known rough edges tracked under v0.1.2 milestone. The onboarding guide includes workarounds for all known issues.