setup-worktree

Create isolated git worktrees with dependencies and environment setup.

3|Updated Aug 28, 2025
One-click install
npx skills add https://github.com/mrgeoffrich/mini-infra --skill setup-worktree-mrgeoffrich
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-worktree
Source: https://github.com/mrgeoffrich/mini-infra/tree/main/.claude/skills/setup-worktree
Command: npx skills add https://github.com/mrgeoffrich/mini-infra --skill setup-worktree-mrgeoffrich

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

It simplifies the process of setting up a clean, ready-to-use git worktree for development or issue resolution, saving time and reducing setup errors.

Core Features & Use Cases

  • Automates worktree creation: Sets up a new branch and directory for isolated work sessions.
  • Pulls latest updates: Ensures the worktree starts from the latest main branch.
  • Installs dependencies: Runs pnpm install to prepare the environment.
  • Optional dev environment warm-up: Warms the dev VM in background, reducing wait times for development.
  • Use Case: Developers can quickly branch off a new isolated environment to fix bugs or experiment without affecting main.

Quick Start

Run the setup-worktree skill with or without a specific issue key, with options to skip environment startup, and it will prepare a ready-to-use worktree for your development session.

Frequently Asked Questions about setup-worktree

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

FAQPage Schema
How do I set up an isolated git worktree for a new feature branch?

To set up an isolated git worktree, run the setup-worktree skill with an optional issue key to automatically create a new branch, pull the latest main updates, and run pnpm install for environment consistency.

Can I skip the dev environment warm-up when creating a git worktree?

Yes, you can skip the dev environment warm-up by running the setup-worktree skill with the option to skip environment startup, allowing you to prepare the worktree without background VM initialization.

Does git worktree setup automatically install dependencies with pnpm?

Yes, git worktree setup automatically installs dependencies by running pnpm install, ensuring your isolated development environment has the required packages and a clean, consistent state before starting tasks.

What's the best way to manage multiple feature branches without affecting the main environment?

The best way to manage multiple feature branches is creating isolated git worktrees, which allow you to branch off into separate directories for bugfixes or experimentation without affecting your main development environment.

When do I need a git worktree for issue resolution?

You need a git worktree for issue resolution when you want to fix bugs or experiment in a clean, isolated environment that ensures environment consistency and prevents setup errors across multiple active development tasks.