# Send Claude Code Orchestrator (tmux-first) to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "claude-code-orchestrator",
    "name": "Claude Code Orchestrator (tmux-first)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Yaxuan42/claude-code-orchestrator",
    "canonicalUrl": "https://clawhub.ai/Yaxuan42/claude-code-orchestrator",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/claude-code-orchestrator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-orchestrator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/bootstrap.sh",
      "scripts/complete-tmux-task.sh",
      "scripts/list-tasks.sh",
      "scripts/monitor-tmux-task.sh",
      "scripts/reconcile-tasks.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "claude-code-orchestrator",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T11:32:26.696Z",
      "expiresAt": "2026-05-08T11:32:26.696Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-orchestrator",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-orchestrator",
        "contentDisposition": "attachment; filename=\"claude-code-orchestrator-0.2.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "claude-code-orchestrator"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/claude-code-orchestrator"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/claude-code-orchestrator",
    "downloadUrl": "https://openagent3.xyz/downloads/claude-code-orchestrator",
    "agentUrl": "https://openagent3.xyz/skills/claude-code-orchestrator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/claude-code-orchestrator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/claude-code-orchestrator/agent.md"
  }
}
```
## Documentation

### Claude Code Orchestrator (tmux-first)

Use tmux-based orchestration for long coding tasks to avoid silent hangs and make progress observable.

### Standard workflow

Create prompt file (avoid long shell quote issues).
Start a dedicated tmux session.
Launch claude --dangerously-skip-permissions in interactive mode.
Paste prompt into Claude.
Require callback command in prompt (via wrapper):
bash {baseDir}/scripts/wake.sh "..." now
Share socket/session attach command with user.
On completion, review diff + lint/build + risk summary.

### Start command

bash {baseDir}/scripts/start-tmux-task.sh \\
  --label "gallery-detail-polish" \\
  --workdir "/Users/yaxuan/.openclaw/workspace/work/active/02-gallery-ops" \\
  --prompt-file "/Users/yaxuan/Downloads/gallery-website-design-system.md" \\
  --task "参考这个修改我当前的画廊官网，注意优先打磨细节和质感，对整体结构展示先不用大改。"

### Monitor commands

# attach
bash {baseDir}/scripts/monitor-tmux-task.sh --attach --session <session>

# capture last 200 lines
bash {baseDir}/scripts/monitor-tmux-task.sh --session <session> --lines 200

### Task overview

List all running cc-* tasks at a glance — useful for "butler-style" summaries.

# Human-readable one-liner per task
bash {baseDir}/scripts/list-tasks.sh

# Structured JSON array (pipe to jq, feed to OpenClaw, etc.)
bash {baseDir}/scripts/list-tasks.sh --json | jq .

Options:

--lines <n> — number of trailing pane lines to capture per task (default 20).
--socket <path> — tmux socket path (default $TMPDIR/clawdbot-tmux-sockets/clawdbot.sock).
--json — emit JSON array instead of human table.
--target ssh --ssh-host <alias> — list sessions on a remote host.

Each entry contains: label, session, status, sessionAlive, reportExists, reportJsonPath, lastLines, updatedAt.

Combine with OpenClaw to generate a periodic butler summary:

# In an OpenClaw prompt / cron:
bash {baseDir}/scripts/list-tasks.sh --json | \\
  openclaw gateway call summarize-tasks --stdin

### Rules

Prefer interactive Claude in tmux for visibility (not long claude -p one-shot for large tasks).
Always include callback via wrapper bash {baseDir}/scripts/wake.sh "..." now in prompt.
Startup script now uses robust submit (ready-check + multi-Enter retry + execution-state detection) to avoid "prompt pasted but not submitted".
If no pane output for >2-3 min, inspect and restart session.
Kill stale Claude processes before restart.
Always return: session name + attach command + current status.

### Status check (zero-token)

If wake not received within expected time, check task status before consuming tokens:

bash {baseDir}/scripts/status-tmux-task.sh --label <label>

Output: STATUS=running|likely_done|stuck|idle|dead|done_session_ended

likely_done / done_session_ended → proceed to completion loop
running → wait
stuck → inspect (attach or capture-pane)
dead → session lost, run complete-tmux-task.sh fallback
idle → Claude may be waiting for input, inspect

### Completion loop (mandatory)

When wake event "Claude Code done (...)" arrives, complete this loop immediately:

Acknowledge user within 60s: "已收到完成信号，正在评估改动".
Preferred path: read completion report generated by Claude Code task:

/tmp/cc-<label>-completion-report.json


If report missing, run local fallback immediately:

bash {baseDir}/scripts/complete-tmux-task.sh --label <label> --workdir <workdir>


Mandatory deep-read: read full JSON/MD report before replying.
Read context before replying:

Read completion report file(s) (/tmp/cc-<label>-completion-report.json/.md)
Read recent tmux transcript (monitor script) to capture what Claude actually did/failed/tried
Incorporate the latest user constraints from current chat


Then provide assistant analysis (not a fixed template):

what was actually completed
what is reliable vs uncertain
key risks/tradeoffs in the user's context
concrete next-step options


Ask explicit decision from user if scope drift exists.

Do not stop at wake-only notification. Wake is trigger, not final delivery.

### Anti-pattern to avoid

Forbidden: one-line fixed reply after wake without reading transcript + report.
Forbidden: only relaying "done + report path" without analysis in user context.
Forbidden: rigid templated output that ignores current conversation context.

### Hard guardrails added

Prompt now enforces “no wake without report”:

task must write /tmp/cc-<label>-completion-report.json + .md
final wake must include report=<json_path>


Recovery command exists for deterministic fallback:

scripts/complete-tmux-task.sh reproduces evidence and emits structured report


Delivery SLA remains mandatory:

wake received -> ack <= 60s -> report
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Yaxuan42
- Version: 0.2.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T11:32:26.696Z
- Expires at: 2026-05-08T11:32:26.696Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/claude-code-orchestrator)
- [Send to Agent page](https://openagent3.xyz/skills/claude-code-orchestrator/agent)
- [JSON manifest](https://openagent3.xyz/skills/claude-code-orchestrator/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/claude-code-orchestrator/agent.md)
- [Download page](https://openagent3.xyz/downloads/claude-code-orchestrator)