worktree — community worktree, workmux, community, ide skills, Claude Code, Cursor, Windsurf

v1.0.0
GitHub

About this Skill

Perfect for Development Agents needing parallel development and version control capabilities with git worktrees and tmux windows. git worktrees + tmux windows for zero-friction parallel dev

raine raine
[0]
[0]
Updated: 3/5/2026

Agent Capability Analysis

The worktree skill by raine is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance.

Ideal Agent Persona

Perfect for Development Agents needing parallel development and version control capabilities with git worktrees and tmux windows.

Core Value

Empowers agents to manage multiple git worktrees using workmux, enabling zero-friction parallel development with automated task launching in new worktrees, leveraging git and tmux protocols.

Capabilities Granted for worktree

Launching multiple development tasks in parallel worktrees
Automating git worktree management with workmux
Streamlining development workflows with tmux window integration

! Prerequisites & Limits

  • Requires git and tmux installation
  • No codebase exploration or implementation allowed
  • Dependent on workmux for task management
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

worktree

Install worktree, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

Launch one or more tasks in new git worktrees using workmux.

Tasks: $ARGUMENTS

You are a dispatcher, not an implementer

HARD RULE — NO EXCEPTIONS: Do NOT explore, read, grep, glob, or search the codebase. Do NOT use the Task/Explore agent. Do NOT investigate the problem. You are a thin dispatcher — your ONLY job is to write prompt files and run workmux add. The worktree agent will do all the exploration and implementation.

If the user's message contains enough context to write a prompt, write it immediately. If not, ask the user for clarification — do NOT try to figure it out by reading code.

If tasks reference earlier conversation (e.g., "do option 2"), include all relevant context in each prompt you write.

If tasks reference a markdown file (e.g., a plan or spec), re-read the file to ensure you have the latest version before writing prompts.

For each task:

  1. Generate a short, descriptive worktree name (2-4 words, kebab-case)
  2. Write a detailed implementation prompt to a temp file
  3. Run workmux add <worktree-name> -b -P <temp-file> to create the worktree

The prompt file should:

  • Include the full task description
  • Use RELATIVE paths only (never absolute paths, since each worktree has its own root directory)
  • Be specific about what the agent should accomplish

Skill delegation

If the user passes a skill reference (e.g., /auto, /plan-review), the prompt should instruct the agent to use that skill instead of writing out manual implementation steps.

Skills can have flags. If the user passes /auto --gemini, pass the flag through to the skill invocation in the prompt.

Example prompt:

[Task description here]

Use the skill: /skill-name [flags if any] [task description]

Do NOT write detailed implementation steps when a skill is specified — the skill handles that.

Flags

--merge: When passed, add instruction to use /merge skill at the end to commit, rebase, and merge the branch.

...
Then use the /merge skill to commit, rebase, and merge the branch.

Workflow

Write ALL temp files first, THEN run all workmux commands.

Step 1 - Write all prompt files (in parallel):

bash
1tmpfile=$(mktemp).md 2cat > "$tmpfile" << 'EOF' 3Implement feature X... 4EOF 5echo "$tmpfile" # Note the path for step 2

Step 2 - After ALL files are written, run workmux commands (in parallel):

bash
1workmux add feature-x -b -P /tmp/tmp.abc123.md 2workmux add feature-y -b -P /tmp/tmp.def456.md

After creating the worktrees, inform the user which branches were created.

Remember: Your task is COMPLETE once worktrees are created. Do NOT implement anything yourself.

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is worktree?

Perfect for Development Agents needing parallel development and version control capabilities with git worktrees and tmux windows. git worktrees + tmux windows for zero-friction parallel dev

How do I install worktree?

Run the command: npx killer-skills add raine/workmux. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for worktree?

Key use cases include: Launching multiple development tasks in parallel worktrees, Automating git worktree management with workmux, Streamlining development workflows with tmux window integration.

Which IDEs are compatible with worktree?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for worktree?

Requires git and tmux installation. No codebase exploration or implementation allowed. Dependent on workmux for task management.

How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add raine/workmux. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use worktree immediately in the current project.

Related Skills

Looking for an alternative to worktree or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

149.6k
0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

138.4k
0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
AI