agent-relay

1# Agent Relay
2 
3Use this skill when Codex needs real-time coordination across multiple agents. It gives Codex a repeatable workflow for:
4 
5- connecting to an Agent Relay workspace
6- spawning relay-aware workers
7- sending direct messages, channel updates, and thread replies
8- keeping lead and worker state synchronized through ACK, STATUS, BLOCKED, and DONE signals
9 
10Relay fills the peer-to-peer gap in Codex sub-agent workflows. Codex can spawn and collect worker results, but Agent Relay gives those workers a shared message bus so they can talk to the lead and to each other.
11 
12## Auto-setup
13 
14On first activation, this skill auto-configures Codex by running `scripts/setup.sh`. This adds the Agent Relay MCP server to `.codex/config.toml`, enables hooks, installs `hooks.json`, and copies the `relay-worker.toml` agent definition. No manual setup is required after installing the skill.
15 
16## Startup protocol
17 
18Every relay-connected Codex agent must complete these steps IN ORDER before substantive work:
19 
201. **Set up a workspace.**
21   - If `RELAY_WORKSPACE_KEY` is set in the environment, call `set_workspace_key` with that key.
22   - If only the legacy `RELAY_API_KEY` alias is set, treat it as the same workspace key.
23   - If no key is available, call `create_workspace` to auto-create one. This returns a workspace key — save it for workers.
24…