using-agent-relaylisted

# Using agent-relay ## Overview Real-time agent-to-agent messaging. Two modes: **tmux wrapper** (real-time, sub-5ms) and **file-based team** (async, simpler). ## When to Use - Multiple agents coordinating on shared codebase - Turn-based interactions (games, reviews, task handoff) - Parallel task distribution - Real-time Claude/Codex/Gemini collaboration **Don't use:** Single agent, cross-host networking, guaranteed delivery required. ## Quick Reference | Pattern | Description | |---------|-------------| | `->relay:Name <<<`...`>>>` | **Default format** - always use fenced format | | `->relay:* <<<`...`>>>` | Broadcast to all agents | | `[[RELAY]]{"to":"Name","body":"msg"}[[/RELAY]]` | Structured JSON | | `\->relay:` | Escape (literal output) | | `relay read <id>` | Read truncated message | ## CLI Commands ```bash relay -f # Start daemon + dashboard relay --status # Check daemon relay --stop # Stop daemon relay wrap -n Alice claude # Wrap agent with messaging relay read abc123 # Read truncated message ``` ### Team Commands (file-based) ```bash relay team send -n You -t Recipient -m "Message" relay team send -n You -t "*" -m "Broadcast" relay team check -n You --no-wait # Non-blocking relay team check -n You --clear # Clear after read relay team status # Show team ``` ## Sending Messages (Tmux Mode) **Output the pattern directly** - don't use bash commands. Always use the fenced