Skip to content
TakoAPI
Back to skills

claude-code-orchestrator

by yaxuan42

Coding Agents & IDEs
603Downloads reported by clawskills.sh
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Trigger Claude Code development tasks in observable tmux sessions with stable startup, progress visibility.

Description

What This Skill Does

Orchestrates Claude Code development tasks inside tmux sessions, keeping progress visible and ensuring a completion callback fires when the task finishes. Long-running coding work runs in a named session that can be attached, monitored, or inspected remotely. On completion, a structured report is generated and analyzed before delivering results.

Unlike a one-shot claude -p call that can hang silently, tmux sessions keep output visible and the mandatory wake callback ensures analysis happens after confirmed completion rather than polling.

When to Use It

  • Running an overnight refactor and getting notified when Claude Code finishes
  • SSHing into a remote machine to check on a running coding task
  • Listing all active Claude Code sessions and their current status at a glance
  • Recovering a stuck or dead session without losing task context
  • Reviewing a structured diff and risk summary after a large automated code change

Example Workflow

INPUT

User asks: Run a gallery website redesign task using Claude Code and notify me when done

AGENT
  1. 1

    Write task instructions to a prompt file to avoid shell quoting issues

  2. 2

    Start a named tmux session via start-tmux-task.sh with the target workdir and prompt file

  3. 3

    Launch Claude Code in interactive mode and paste the prompt with a wake callback command embedded

  4. 4

    Return the tmux attach command so the user can observe progress over SSH

  5. 5

    On wake event, read the completion report JSON and tmux transcript, then provide diff summary and risk analysis

OUTPUT

Session name, attach command, and a structured completion analysis covering what changed, reliability of the output, and concrete next steps

Requirements

  • Claude Code CLI (claude command) installed and authenticated
  • Anthropic API key or Claude Pro/Max subscription for Claude Code

Installation

clawhub install yaxuan42/claude-code-orchestrator

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links