| name | claude-relay |
| description | Relay operator for Claude Code via tmux across multiple projects. Use when the user wants to start/continue a Claude Code terminal session, send prompts, read output, or manage background Claude sessions by project name/path. |
| metadata | {"openclaw":{"emoji":"🔄","requires":{"bins":"[Truncated]"}}} |
Claude Relay
Operate Claude Code as a persistent terminal copilot through tmux.
Script
All actions go through scripts/relay.sh. Run with no args for usage help.
scripts/relay.sh <action> [project] [args...]
Actions: start, send, tail, stop, status, session
Workflow
- Start session:
scripts/relay.sh start <project>
- Send instruction:
scripts/relay.sh send <project> "<text>"
- Read output:
scripts/relay.sh tail <project> [lines]
- Repeat send/tail as needed.
- Stop when done:
scripts/relay.sh stop <project>
Project resolution
The script resolves <project> in order:
- Absolute path (if directory exists)
- Alias from
projects.map (name=/abs/path)
$CLAUDE_RELAY_ROOT/<name> exact match
- Find under
$CLAUDE_RELAY_ROOT (maxdepth=2) by folder name