AgentRelay

AgentRelay is a local web relay for agent CLIs. It starts a local browser UI, owns the middle layer, and connects that UI to Codex now, with room for OpenCode and Claude Code adapters later.

Install

npm i -g @wojwo/agentrelay
agentrelay

AgentRelay requires Node.js 20 or newer. Codex support requires the codex command on PATH.

Startup

If no access token is configured, AgentRelay asks you to enter one first and stores only its hash in ~/.agentrelay/config.toml. Token length is unrestricted.

On interactive terminals, AgentRelay asks which agent backend to use, then asks how the browser should connect. Use Up/Down and Enter to choose. Codex is the only backend available for now.

> Codex

> Local only
  Cloudflare Tunnel
  FRPC config

Cloudflare mode runs Cloudflare Tunnel through npm/npx, extracts the trycloudflare.com URL, prints it, and prints a terminal QR code.

FRPC mode checks that frpc is available on PATH, then looks for .toml files in the current directory. If more than one config exists, AgentRelay asks which one to use.

Non-interactive usage:

AGENTRELAY_TOKEN=your-token agentrelay --connection local
agentrelay --agent codex --connection local
agentrelay --connection local
agentrelay --connection cloudflare
agentrelay --connection frpc --frpc-config ./frpc.toml

If your FRPC config has a public URL, add this helper field so AgentRelay can print it:

public_url = "https://your-domain.example"

Data

Config is stored at:

~/.agentrelay/config.toml

Existing ~/.phone2gpt/config.toml files are copied to the new location on first run.