using-git-worktrees

Git worktrees allow you to work on multiple branches simultaneously by creating isolated workspaces that share repository history. They solve the problem of needing feature isolation without constantly switching branches, reducing context-switching and risk of interfering with the main workspace.

To prevent accidental commits, this skill verifies that the chosen worktree directory is ignored by Git. It performs safety verification and suggests adding the directory to .gitignore if needed to protect your main repository history.

Yes, after worktree creation, the skill auto-detects the project type and runs project setup commands, such as installing dependencies. This ensures a clean baseline for safe experimentation without touching the main working tree.

Yes, you can use custom project-local or global locations for your Git worktrees. The skill handles directory existence checks and case sensitivity across .worktrees and worktrees folder naming conventions before creating the isolated workspace.

Git worktrees are limited by directory existence conflicts if the target path is already populated, and they require proper .gitignore configuration to prevent accidental commits of the worktree directory itself into the main repository history.