Relay
Call Claude Code like a function:
relay(task, session?) → {status, verify, body}
Use the relay script at scripts/relay (inside this skill directory) to generate request/response files. Do not manually construct frontmatter.
One-Shot Call
Run as a single chained command so shell variables persist:
REQ=$(~/.codex/skills/relay/scripts/relay req --from codex --to claude --name auth-review "Review src/auth.py for security issues. Run pytest to verify.") && env -u CLAUDECODE claude --model claude-opus-4-6 -p --dangerously-skip-permissions "Read and execute $REQ"
Read the response:
RES="${REQ%.req.md}.res.md"
Session Call
Sessions keep turn history so the receiver sees full context from both agents.
REQ=$(~/.codex/skills/relay/scripts/relay req --from codex --to claude --session auth-refactor "Fix the issues from my review. Run pytest to verify.") && env -u CLAUDECODE claude --model claude-opus-4-6 -p --dangerously-skip-permissions "Read and execute $REQ"
Read the response:
RES="${REQ%.req.md}.res.md"
Output
Read the response file:
- •status:
done|error - •verify:
pass|fail|skip - •body: findings, changes, reasoning — free-form markdown
If the request includes a verify command, run it and set verify: pass or verify: fail; include the command and key result in the body. If no verify command is provided or verification is not feasible, set verify: skip and state why briefly.
If the response file is missing, report failure — do not retry.