claude-master

Spawn and orchestrate child Claude Code sessions in tmux windows.

1|1|Updated Nov 25, 2024
One-click install
npx skills add https://github.com/joeledwardson/dev-setup --skill claude-master-joeledwardson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-master
Source: https://github.com/joeledwardson/dev-setup/tree/main/configs/claude/skills/claude-master
Command: npx skills add https://github.com/joeledwardson/dev-setup --skill claude-master-joeledwardson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing multiple parallel Claude Code sessions across different projects is chaotic — sessions get lost, names clash, and there is no central point of control. This Skill turns one Claude session into a dedicated orchestrator that spawns, names, messages, and cleans up child Claude sessions running in tmux. ## Core Features & Use Cases - Child Session Spawning: Creates named tmux sessions running sandboxed Claude Code instances (with permission bypass flags) in any project directory, then verifies startup and enables remote control. - Session Management: Lists active Claude sessions, sends messages to named children via remote-control or tmux send-keys fallback, and kills sessions on explicit request. - Port Dashboard: Ensures the always-on port-dash dashboard is running at port 9999 so you can monitor services across sessions. - Use Case: Say "spin up yolo Claudes for my api and frontend repos" and the master session creates two named tmux sessions, boots a permission-bypassed Claude in each, enables remote control, and hands you the attach commands. ## Quick Start Ask the master session to spin up a new Claude session for your project directory, for example: "start a new claude session in ~/projects/my-app".

Frequently Asked Questions about claude-master

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run multiple Claude Code sessions in parallel?

Use tmux to run each Claude Code session in its own named session, with one master session orchestrating them. The master spawns children with tmux new-session, names them with the -n flag, and messages them via remote-control or tmux send-keys.

How do I send a message to another Claude Code session?

Enable remote-control on the child session by sending the /remote-control slash command after startup, then push prompts to it by name. If remote-control is unavailable, fall back to tmux send-keys to type directly into the child's pane.

What does a tmux cowork session mean in this setup?

A cowork session means a tmux session with a sandboxed Claude Code instance running inside it, not an empty pane. It is created with permission-bypass flags so the child Claude can work autonomously on the target repo.

Why does --dangerously-skip-permissions fail in newer Claude Code versions?

Recent Claude Code versions require --allow-dangerously-skip-permissions alongside the bypass flag, otherwise the flag is rejected. Verify the current flag requirements against claude --help if the spawn command stops working.

When should the master session not do work itself?

The master session only orchestrates and must never edit files, run builds, or debug. All development work belongs in child sessions, and children manage their own long-running commands rather than the master reaching into their tmux panes.