OpenClaw

claude-relay

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.

artwalker0 来源安装数☆ 0 仓库 Stars

查看来源 ↗安装与使用 SKILL.md ↗

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

SkillHub CLI

skillhub install artwalker/claude-relay

打开来源仓库，查看说明和兼容环境后，按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent，让它先读取说明、核对依赖，并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

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_BIN env or default path.
Session not running (send/tail on stopped session): exits code 6. Start first.
Project not found: exits code 4. Check projects.map or project path.
Claude process hung: tail still works — check output. If stuck, stop and start fresh.

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 `projec...

来源信息

Source: github
Repository: openclaw/skills
Path: skills/artwalker/claude-relay
Version: —
Commit: 1186a298b34643d666945b2af3cba80e1f4071bd
分类来源: rules
状态: active
可见性: public

这些信息来自收录时的来源分析，可能滞后；使用前请核对最新来源文件。

来源内容

SKILL.md

# 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.

```bash
scripts/relay.sh <action> [project] [args...]
```

**Actions**: `start`, `send`, `tail`, `stop`, `status`, `session`

## Workflow

1. Start session: `scripts/relay.sh start <project>`
2. Send instruction: `scripts/relay.sh send <project> "<text>"`
3. Read output: `scripts/relay.sh tail <project> [lines]`
4. Repeat send/tail as needed.
5. Stop when done: `scripts/relay.sh stop <project>`

## Project resolution

The script resolves `<project>` in order:

1. Absolute path (if directory exists)
2. Alias from `projects.map` (`name=/abs/path`)
3. `$CLAUDE_RELAY_ROOT/<name>` exact match
4. Find under `$CLAUDE_RELAY_ROOT` (maxdepth=2) by folder name
5. 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_BIN` env or default path.
- **Session not running** (send/tail on stopped session): exits code 6. Start first.
- **Project not found**: exits code 4. Check `projects.map` or project path.
- **Claude process hung**: `tail` still works — check output. If stuck, `stop` and `start` fresh.

## 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

1. Install this skill
2. Create a `projects.map` file in the skill directory (see `projec...

搜索