Skip to content
TakoAPI
Back to skills

claude-tmux-runner

by xaiohuangningde

DevOps & Cloud
—Not yet rated
Your rating

Brief

Claude Code parallel task manager with tmux backend.

Description

What This Skill Does

Runs multiple Claude Code tasks in parallel using tmux sessions. Each task executes in the background so the main session stays unblocked. Includes commands for listing, monitoring, and stopping tasks.

Lets you queue and run multiple Claude Code jobs simultaneously without blocking your terminal or waiting for one to finish before starting the next.

When to Use It

  • Generating a Python auth module and React component at the same time
  • Checking progress on a background Claude task mid-conversation
  • Running three microservice scaffolds in parallel without waiting
  • Stopping a specific background task without killing the terminal
  • Reviewing all generated files across concurrent jobs when they finish

Example Workflow

INPUT

User asks: Build a Go microservice and a React UI component at the same time

AGENT
  1. 1

    Optimizes prompts for each task and shows them for user approval

  2. 2

    Starts both as separate background tmux sessions

  3. 3

    Returns immediately so the user can continue chatting

  4. 4

    Checks individual task status when user asks for an update

  5. 5

    Lists generated files in ~/.openclaw/workspace/ when tasks complete

OUTPUT

Both tasks finish in the background; user retrieves generated files without having waited for either to complete

Requirements

  • tmux installed on the system
  • Claude Code CLI installed and authenticated

Installation

clawhub install xaiohuangningde/claude-tmux-runner

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

Links