skills.rest
KazusaNakagawa
KazusaNakagawaCOMMUNITY
Explore all skills by this author →
𝕏@kazusa_nakagawaGitHub

parallel-setup

Create Git worktrees and launch Claude Code sessions in tmux panes for parallel development.

Updated Mar 14, 2026
Search Tags:#git#workflow#devops#worktrees#tmux#claude-code#parallel-development
One-click install
npx skills add https://github.com/KazusaNakagawa/claude_docs --skill parallel-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: parallel-setup
Source: https://github.com/KazusaNakagawa/claude_docs/tree/main/.claude/skills/parallel-setup
Command: npx skills add https://github.com/KazusaNakagawa/claude_docs --skill parallel-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates parallel feature development by running multiple Claude Code sessions in a single tmux window using distinct git worktrees, reducing context switching and coordination overhead.

Core Features & Use Cases

  • Parallel workspaces: Create independent worktrees for 2–4 workers and view them in split panes or multiple tmux windows.
  • Automated startup: Auto-launch Claude Code sessions per pane and pre-load development tasks.
  • Workflow visibility: Centralized monitoring of progress across all workers in one screen, enhancing collaboration.

Quick Start

Run /parallel-setup to initialize a 2–4 worker parallel development session, then attach to the tmux session and begin.

Frequently Asked Questions about parallel-setup

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

FAQPage Schema
How do I run multiple Claude Code sessions in parallel for feature development?▼

Run multiple Claude Code sessions in parallel by initializing a tmux session with split panes, where each pane uses a dedicated git worktree for an independent branch. This setup reduces context switching and coordination overhead.

How does git worktree help with parallel development across multiple workers?▼

Git worktrees enable parallel development by creating independent working directories for 2–4 workers within a single repository. Each worker gets a distinct branch and isolated workspace, allowing simultaneous feature implementation without file conflicts.

What's the best way to monitor progress across multiple parallel feature branches?▼

Monitor progress across parallel feature branches by using a centralized split-layout tmux session. This configuration provides single-screen visibility into all active workers, enhancing workflow monitoring and collaboration.

Can I use tmux panes to manage 2 to 4 parallel git worktrees simultaneously?▼

Yes, you can manage 2 to 4 parallel git worktrees simultaneously using tmux panes. The setup configures a split-layout tmux window and auto-launches a dedicated Claude Code session per pane to automate startup.

How do I start a parallel development session with tmux and Claude Code?▼

Start a parallel development session by running the setup command to initialize 2–4 workers. The process enforces prerequisites, creates worktrees, configures the tmux split layout, and launches Claude Code per worker automatically.

Do I need git worktrees to coordinate parallel work in a single repository?▼

Yes, git worktrees are required for parallel work in a single repository because they provide independent branches for 2–4 workers. This isolation prevents checkout conflicts and ensures pane-based visibility across simultaneous tasks.

Related Skills

Explore More Software Engineering Skills→
blueif16blueif16

execution-manager

Create isolated git worktrees and tmux sessions for parallel sub-coordinators.

Community
Advanced
otrebuotrebu
4

finish-feature

Merge a feature branch into main with conflict handling and push.

Community
Basic
toqoztoqoz

fork-session

Spawn isolated Claude sessions in git worktrees via tmux panes.

Community
Advanced
takemo101takemo101
1

pi-issue-runner

Create isolated pi worktrees and multiplexed sessions from GitHub issues.

Community
Advanced