You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Real-time communication between coding harnesses. Let Claude send messages to codex and stop babysitting your agents.
8
7
9
-
</div>
8
+
## What you can build with it today
10
9
11
-
## Multi Agent Orchestration
10
+
-**Claude orchestrates, Codex implements.** <br/>Spawn a Claude lead that hands work to Codex workers, reads their progress live, and steers mid-task when one goes off the rails.
11
+
-**Adversarial review loops.** <br/>Run an implementer alongside one or two critics. They iterate until the critic ratifies — no human in the loop.
12
+
-**Walk-away autonomy.** <br/>Kick off a multi-step job, close the laptop. Agents keep talking, finishing, and verifying each other's work.
12
13
13
-
Enable your Claude Code, Codex, OpenCode agent spawn agent teams that can communicate and collaborate. Not subagents, but real agents who
14
-
could spawn their own subagents. This allows for powerful AI cross-collaboration so you can get the best harnesses + models working
15
-
together.
14
+
## Get started
16
15
17
-
## Benefits Over Subagents
16
+
1. Install the agent-relay CLI:
18
17
19
-
1. The agent orchestrating has full insight what the spawned agents are doing. It can read the logs and steer mid turn if needed
20
-
2. Enables advanced swarm techniques as each agent can communicate with each other and coordinate to form agent teams for different types: review/fix loops, adversarial/debate pairs, fan-out -> pipeline -> gather, or lead + workers to name a few
21
-
3. Diversity of thought and implementation. Codex implement, Claude review, Gemini do the final verification leads to better results as different models + harnesses excel in different things.
22
-
4. Review happens as a conversation between the live reviewer and the live implementer, not as a report handed back to the parent after each one finishes.
23
-
5. Audit trail exists outside the agent and outside the parent. With the [Agent Relay Observer](https://agentrelay.com/observer) you get full auditability into every single DM and group message sent by the agents.
Subagents are the right tool when work is a single well-scoped one-shot. Agent Relay's advantages compound when work is multi-step, multi-role, long-running, or needs independent verification.
39
37
40
-
3. Tell your agent to use it
41
-
42
-
```
43
-
use the orchestrating-agent-relay skill to spawn a claude and codex agent and [YOUR_TASK]
44
-
```
45
-
46
-
For single, well-scoped, one-shot tasks, subagents still win. Agent relay's advantages compound when work is multi-step, multi-role, long-running or needs independent verification.
38
+
-**Mix models and harnesses.** Codex implements, Claude reviews, Gemini verifies — each model used for what it's best at, not whatever the parent harness happens to be.
39
+
-**Live steering.** The orchestrator reads logs and DMs as workers run and can redirect mid-turn instead of waiting for a final report.
40
+
-**Review as a conversation.** The reviewer and implementer talk while the code is being written, not after the fact.
41
+
-**Swarm patterns out of the box.** Review/fix loops, adversarial debate pairs, fan-out → pipeline → gather, lead + workers.
42
+
-**Audit trail outside the agent.** Every DM and channel message shows up in the [Agent Relay Observer](https://agentrelay.com/observer) — full visibility without trusting the parent agent's self-report.
47
43
48
44
## SDK
49
45
50
-
Use the Agent Relay SDK to spawn and control agents programmatically.
Type "tmux kill-session -t debate 2>/dev/null; agent-relay down 2>/dev/null; true" Enter
40
+
Sleep 2s
41
+
42
+
Type "agent-relay up --no-spawn >/tmp/agent-relay-vhs.log 2>&1 &" Enter
43
+
Sleep 5s
44
+
45
+
# Build the 3-pane layout
46
+
Type "tmux new-session -d -s debate -x 240 -y 60" Enter
47
+
Type "tmux split-window -h -p 45 -t debate" Enter
48
+
Type "tmux split-window -v -t debate:0.1" Enter
49
+
50
+
# Spawn reviewer (top-right, pane 0.1) with its task — broker injects when Claude is ready.
51
+
# IMPORTANT: must use the verbose `new` verb (not `-n` shorthand) so --task and --model
52
+
# are parsed by agent-relay instead of being passed through to claude as unknown options.
53
+
Type `tmux send-keys -t debate:0.1 "agent-relay new reviewer claude --attach --mode passthrough --ephemeral --model sonnet --task 'Watch the general channel using mcp__relaycast__message_inbox_check every 20 seconds. When planner and adversarial deadlock, post a synthesis to general via mcp__relaycast__message_post and say REVIEWER ratified.'" Enter` Enter
54
+
Sleep 1s
55
+
56
+
# Spawn adversarial (bottom-right, pane 0.2) with its task
57
+
Type `tmux send-keys -t debate:0.2 "agent-relay new adversarial claude --attach --mode passthrough --ephemeral --model sonnet --task 'Watch the general channel via mcp__relaycast__message_inbox_check every 15 seconds. When planner posts a plan, find 3 biggest flaws and post critique via mcp__relaycast__message_post. Iterate. Say ADVERSARIAL satisfied when convinced.'" Enter` Enter
58
+
Sleep 1s
59
+
60
+
# Focus planner pane and attach VHS to tmux
61
+
Type "tmux select-pane -t debate:0.0" Enter
62
+
Type "tmux attach -t debate" Enter
63
+
Sleep 2s
64
+
65
+
# Give reviewer and adversarial time to boot and start polling
66
+
Sleep 18s
67
+
68
+
# ---------- Recording starts ----------
69
+
Show
70
+
71
+
# Spawn planner with its task — the typed command IS the visible kickoff
72
+
Type `agent-relay new planner claude --attach --mode passthrough --ephemeral --model sonnet --task "You are the planner. Two other agents are listening on the general channel: adversarial (critic) and reviewer (arbitrator). Draft a plan to migrate our auth service from session cookies to OAuth2, zero downtime, 50k DAU. Post the plan to general via mcp__relaycast__message_post. Iterate with adversarial until they ratify."`
73
+
Sleep 600ms
74
+
Enter
75
+
76
+
# Show debate: ~100s real -> ~40s in the GIF at 2.5x playback
77
+
Sleep 100s
78
+
79
+
# ---------- Cleanup ----------
80
+
Hide
81
+
Type "tmux kill-session -t debate; agent-relay down" Enter
0 commit comments