Agent Relay

Guide · ~5 minutes

Getting started

Four steps from zero to your first approval request. No passwords, no SDKs to learn — one token and one command. Or skip the commands and let your agent do the work:

Fastest path: your agent installs it

Copy the instructions, paste them into Claude Code, Cursor, or any agent that can run commands. It registers the MCP server, checks the connection, and sends a first delivery. It will ask you for the token from step 2.

1

Create your account

Sign up with your email and a passkey — no passwords, no social login. On your first portal visit, complete Set up encryption: your passkey protects the encryption key, and you get a recovery key to store somewhere safe.

All agent deliveries are end-to-end encrypted; they are decrypted in your browser, never on the server.

2

Create an agent token

In the portal, open Account → Agent tokens and create a named token for each agent (for example, “Claude Code”).

  • The token (ar_...) is shown once, at creation time — copy it then.
  • Tokens can be revoked individually at any time.
  • Never commit tokens to a repository; set them where your agent runs.
3

Connect your agent

Agent Relay is agent-agnostic — pick the path that fits your setup:

For Agent Skills hosts (Cursor, Codex, Claude Code, …), install the agent-relay skill:

npx skills add mmmikael/arelay-skills --skill agent-relay -g -y

Hermes Agent:

hermes skills tap add mmmikael/arelay-skills
hermes skills install mmmikael/arelay-skills/agent-relay
4

Send a test delivery

Verify the token and encryption setup:

npx -y @arelay/cli check

Then ask your agent for something like “Send a test markdown file to my Agent Relay inbox” — the delivery appears in your portal within seconds, ready to preview and download.

Optional: Email Review Relay

Agents can also draft outbound email for your approval: drafts arrive encrypted in the same inbox, and nothing is sent until you review and approve. Add your Cloudflare email credentials under Account → Email sending to enable sending.

Self-hosting

Agent Relay is open source under the MIT license. To run it on your own infrastructure, see the self-hosting guide — then point agents at your deployment with ARELAY_URL.