worktree

Create parallel git worktrees and tmux windows via workmux add.

2.1k|295|Updated Nov 4, 2025
One-click install
npx skills add https://github.com/raine/workmux --skill worktree-raine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree
Source: https://github.com/raine/workmux/tree/main/skills/worktree
Command: npx skills add https://github.com/raine/workmux --skill worktree-raine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the creation and orchestration of parallel git worktrees and their tmux windows, enabling multiple tasks to run concurrently without manual configuration.

Core Features & Use Cases

  • Launch parallel worktrees and associated tmux windows using workmux add
  • Automatically generate descriptive, 2-4 word kebab-case worktree names for each task
  • Compose and dispatch task prompts to agents without implementing code yourself
  • Support a dispatcher workflow that handles task context, references, and relative paths
  • Stepwise workflow: write prompts to temp files and create worktrees in controlled steps

Quick Start

Use the worktree skill to create a new worktree for a given task by providing a task description. The workflow will generate a name, create a prompt file, and execute workmux add <worktree-name> -b -P <temp-file> to materialize the worktree.

Frequently Asked Questions about worktree

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

FAQPage Schema
How do I automate parallel git worktrees for concurrent task execution?

Parallel git worktrees enable multiple tasks to run concurrently in isolated branches without manual setup. This Skill automates worktree creation and orchestration by generating kebab-case names, composing task prompts, and invoking workmux to materialize worktrees and tmux windows in controlled steps.

Can I delegate tasks to multiple agents using git worktrees and tmux?

Yes. This Skill orchestrates parallel worktrees and tmux windows for multi-agent workflows, automatically generating descriptive names and dispatching task prompts to agents without code execution, enabling deterministic task delegation across isolated environments.

What's the workflow for creating and managing concurrent worktrees with tmux?

The workflow generates a 2-4 word kebab-case worktree name, writes a task prompt to a temp file, and executes workmux add with the name and prompt file path. This creates an isolated worktree and associated tmux window, ready for agent execution in a controlled, stepwise process.

Do I need to manually configure tmux windows for each worktree?

No. This Skill automates tmux window creation alongside worktrees through workmux, eliminating manual configuration and ensuring deterministic naming and prompt dispatch for parallel task orchestration.

How does task context and relative paths work in a dispatcher workflow?

The Skill handles task context, references, and relative paths within the dispatcher workflow by composing prompts that capture task scope and environment, then dispatching them to worktrees via workmux, preserving context across parallel executions.