---
name: pair
description: Start, inspect, accept, reject, or send messages in an Agent Relay two-agent pair session. Use when the user invokes /pair or asks to pair this agent with Codex, Claude, or another relay agent.
argument-hint: "<target|status|accept|reject|send> [args]"
allowed-tools: [Bash]
---

# Agent Relay Pair

Run the Agent Relay CLI with the user's arguments:

```bash
agent-relay /pair $ARGUMENTS
```

Use this for pair-session commands such as:

```bash
agent-relay /pair codex "Debug flaky tests"
agent-relay /pair status
agent-relay /pair accept PAIR_ID
agent-relay /pair reject PAIR_ID
agent-relay /pair send PAIR_ID --stdin <<'EOF'
What do you see?
EOF
```

Report the command output briefly. If the CLI cannot detect this session's agent id, rerun with `--agent AGENT_ID` or `--from AGENT_ID` using the Agent Relay ID shown in session context.

Always pass the message body via a quoted heredoc into `--stdin` (or `--body-file PATH`), never inline in the shell command: backticks / `$(...)` in a body are otherwise command-substituted by your shell before `agent-relay` runs (#1263).