worktree

Dispatches tasks into new git worktrees using workmux with generated prompt files.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/wesbragagt/nixos-config --skill worktree-wesbragagt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree
Source: https://github.com/wesbragagt/nixos-config/tree/main/home/skills/worktree
Command: npx skills add https://github.com/wesbragagt/nixos-config --skill worktree-wesbragagt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires workmux.

What problem does it solve? Running multiple coding tasks in parallel on the same repository causes branch conflicts and context mixing. This Skill acts as a thin dispatcher that spins up isolated git worktrees via workmux, each with its own detailed prompt file, so agents can implement tasks independently. ## Core Features & Use Cases - Parallel task dispatch: Write a prompt file per task and run workmux add <name> -b -P <file> to create one worktree per task. - Skill delegation: Pass skill references like /auto or /plan-review (with flags) through to the worktree agent instead of writing manual implementation steps. - Workflow flags: Use --merge to have the agent commit, rebase, and merge via the /merge skill, or --fork to copy the current conversation context into the new worktree. - Use Case: You have three independent bug fixes. Invoke the skill with all three tasks; it writes three prompt files and creates three worktrees, each with its own branch and agent. ## Quick Start Ask the assistant to launch your tasks in new git worktrees using the worktree skill, optionally with --merge or --fork flags.

Frequently Asked Questions about worktree

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

FAQPage Schema
How do I run multiple coding tasks in parallel git worktrees?

Pass your tasks to the worktree skill, which writes a detailed prompt file per task and runs workmux add for each one. Every task gets its own worktree and branch, so agents work independently without conflicts.

What is workmux and how does the worktree skill use it?

workmux is a tool for creating git worktrees, invoked here via workmux add <name> -b -P <prompt-file>. The skill generates a kebab-case worktree name and a temp prompt file, then runs the command from the current directory so the new worktree branches from the checked-out branch.

Can I pass another skill like /auto to a worktree agent?

Yes. Include the skill reference in your request and the dispatcher writes it into the prompt file, including any flags like --gemini. The worktree agent then executes that skill instead of following manual implementation steps.

What does the --fork flag do when creating a worktree?

The --fork flag copies the current conversation into the new worktree so the agent resumes with full context. The prompt is prepended with instructions preventing the forked agent from recursively dispatching more worktrees.

When should I not use the worktree skill?

Avoid it when tasks are tightly coupled or must share uncommitted state, since each worktree is an isolated checkout. It is also unnecessary for a single small change you can implement directly in the current branch.