worktree-setup

Create a Git worktree with VS Code workspace and cmux terminal configuration.

Updated Nov 9, 2025
One-click install
npx skills add https://github.com/manifoldlogic/claude-code-plugins --skill worktree-setup-manifoldlogic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-setup
Source: https://github.com/manifoldlogic/claude-code-plugins/tree/main/plugins/devx/skills/worktree-setup
Command: npx skills add https://github.com/manifoldlogic/claude-code-plugins --skill worktree-setup-manifoldlogic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires crewchief, git, docker, cmux, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of a Git worktree with a VS Code workspace and cmux terminal setup, streamlining the development environment setup process.

Core Features & Use Cases

  • Git Worktree Creation: Automatically creates a new Git worktree for a given ticket.
  • VS Code Workspace Update: Adds the new worktree to the VS Code workspace file.
  • cmux Terminal Setup: Configures a cmux terminal workspace for efficient terminal management.
  • Devcontainer Session: Opens a devcontainer session within the new workspace.
  • Navigation and Launch: Navigates to the worktree directory and launches claude for immediate use.
  • Use Case: When starting work on a new ticket, this Skill provides a complete development environment with a single command.

Quick Start

Create and set up a worktree for a ticket 'DEVX-1001':

setup-worktree.sh DEVX-1001

Frequently Asked Questions about worktree-setup

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

FAQPage Schema
How do I automate Git worktree setup with VS Code and cmux terminal configuration?

To automate Git worktree setup, you can use a script that creates the worktree, updates the VS Code workspace file, configures a cmux terminal workspace, and opens a devcontainer session. Pass the ticket identifier to the setup script to trigger the full environment configuration.

What does a Git worktree do for development environment setup?

A Git worktree allows you to create a separate working directory for a specific ticket without cloning the entire repository. It enables isolated development environments with dedicated VS Code workspaces and cmux terminal configurations for parallel branch work.

Do I need Docker and cmux to use this Git worktree automation?

Yes, Docker and cmux are required dependencies. Docker is needed to open the devcontainer session within the new workspace, while cmux is used to configure the terminal workspace for efficient terminal management during development.

Can I open a devcontainer session within a new Git worktree workspace?

Yes, the worktree setup process opens a devcontainer session within the newly created workspace. After creating the Git worktree and updating the VS Code workspace file, it navigates to the worktree directory and launches the devcontainer environment.

What's the best way to manage terminal sessions when working with multiple Git worktrees?

Using cmux terminal configuration provides efficient terminal management for multiple Git worktrees. The setup process automatically configures a cmux terminal workspace alongside the VS Code workspace, keeping terminal sessions organized per worktree.

Why does my Git worktree setup require CrewChief CLI?

CrewChief CLI is a required dependency for the worktree setup process. It handles the orchestration of creating the Git worktree, updating the VS Code workspace file, and managing the cmux terminal and devcontainer session configuration.