using-git-worktrees

Create isolated Git worktrees with safety and baseline checks.

22|4|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/ivfarias/ceo --skill using-git-worktrees-ivfarias
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/ivfarias/ceo/tree/main/.gemini/skills/using-git-worktrees
Command: npx skills add https://github.com/ivfarias/ceo --skill using-git-worktrees-ivfarias

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Isolate feature development by creating isolated git worktrees that share the same repository, enabling experimentation without touching the main workspace.

Core Features & Use Cases

  • Directory priority: prefer .worktrees, then worktrees, then global location; can read CLAUDE.md to influence choice.
  • Safety verifications: ensure created worktrees are ignored by gitignore before creation; run baseline checks after creation.
  • Flexible deployment: supports project-local worktrees and global worktrees; auto-detects project name and branch strategy to streamline setup.

Quick Start

Create an isolated git worktree for the current project by selecting a location, verifying ignore rules, and performing the worktree creation and baseline checks.

Frequently Asked Questions about using-git-worktrees

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

FAQPage Schema
How do I create an isolated Git worktree for feature development?

Create an isolated Git worktree by selecting a project-local or global directory, verifying gitignore rules, and running baseline checks to safely develop features without mutating the main working tree.

What is the best way to manage multiple Git branches without touching the main workspace?

Git worktrees provide isolated working directories linked to the same repository, allowing you to manage multiple branches and experiment safely without altering the main workspace.

Can I configure Git worktrees to use a custom directory location?

Yes, you can configure Git worktrees in project-local directories like .worktrees or worktrees, or use a global location, with priority determined by existing directories or CLAUDE.md preferences.

Do I need to update .gitignore before adding a Git worktree?

Yes, safety verifications ensure the chosen worktree directory is ignored by gitignore before creation, preventing the isolated working tree from being tracked by the main repository.

Does Git worktree creation support automated project setup?

Yes, after creating the Git worktree and verifying ignore rules, the process runs optional project setup and baseline checks to ensure the isolated environment is fully configured.

What are the limitations of using global Git worktrees?

Global Git worktrees store isolated branches outside the project directory, which requires manual path management and may complicate project-specific setup automation compared to local worktrees.