claude-tmux-runner
by xaiohuangningde
DevOps & CloudBrief
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
User asks: Build a Go microservice and a React UI component at the same time
- 1
Optimizes prompts for each task and shows them for user approval
- 2
Starts both as separate background tmux sessions
- 3
Returns immediately so the user can continue chatting
- 4
Checks individual task status when user asks for an update
- 5
Lists generated files in ~/.openclaw/workspace/ when tasks complete
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-runnerRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.