modbender 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 - If omitted, re-use last project
Multiple matches → script exits with candidates; ask user to clarify.
Session naming
Deterministic: cc_<basename_sanitized>. One project = one tmux session.
Error handling
- tmux not installed: script exits with code 2 and "missing dependency" message.
- Claude binary not found: same exit code 2. Verify
CLAUDE_BINenv or default path. - Session not running (send/tail on stopped session): exits code 6. Start first.
- Project not found: exits code 4. Check
projects.mapor project path. - Claude process hung:
tailstill works — check output. If stuck,stopandstartfresh.
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.mapfile in the skill directory (seeprojects.map.example) - Ensure
tmuxandclaudeare installed and in your PATH
Notes
- Transport-focused skill (relay/orchestration), not deep code reasoning.