| name | claude-relay |
| description | Relay operator for Claude Code via tmux across multiple projects. Start/continue persistent Claude Code terminal sessions, send prompts, read output, and manage background sessions by project name or path. |
| metadata | {"openclaw":{"emoji":"🔄","requires":{"bins":["tmux","claude"]}}} |
Claude Relay
Operate Claude Code as a persistent terminal copilot through tmux.
Use this skill for
- Starting a Claude Code session in a project directory
- Sending prompts to a running Claude session
- Reading Claude's output (tail)
- Managing multiple concurrent project sessions
Script
Use scripts/relay.sh for all actions. Prefer script actions over ad-hoc shell so behavior stays deterministic.
Project resolution rules
The script resolves project in this order:
- Absolute path (if exists)
- Alias from
projects.map in the skill folder (name=/abs/path)
$CLAUDE_RELAY_ROOT/<name> exact match- Find under
$CLAUDE_RELAY_ROOT (maxdepth=2) by folder name
- If omitted, re-use last project
If multiple matches are found, ask user to disambiguate.
Standard workflow
- Start or reuse session for target project:
scripts/relay.sh start <project-or-path>
- Send user instruction:
scripts/relay.sh send <project-or-path> "<instruction>"
- Read output:
scripts/relay.sh tail <project-or-path> [lines]
- Repeat send/tail loop.
- Stop when asked:
scripts/relay.sh stop <project-or-path>
Session naming
- Session name is deterministic:
cc_<project_basename_sanitized>
- One project ↔ one tmux session
Quick commands
scripts/relay.sh start myproject
scripts/relay.sh send myproject "fix the failing tests"
scripts/relay.sh tail myproject 80
scripts/relay.sh status
scripts/relay.sh stop myproject
Environment variables
| Variable | Default | Description |
|---|
CLAUDE_RELAY_ROOT | $HOME/projects | Root directory for project discovery |
CLAUDE_RELAY_MAP | <skill-dir>/projects.map | Path to project alias map file |
CLAUDE_BIN | claude (from PATH) | Path to Claude Code CLI binary |
RELAY_WAIT | 6 | Seconds to wait after send before tailing output |
Setup
- Install this skill
- Create a
projects.map file in the skill directory (see projects.map.example)
- Ensure
tmux and claude are installed and in your PATH
Notes
- This skill is transport-focused (relay/orchestration), not deep code reasoning.
- For heavy design/review, switch to a stronger model before synthesis.
