using-git-worktrees

To isolate feature development from your main Git workspace, you can set up isolated Git worktrees that safely experiment on new features without disturbing the main working directory.

To create a Git worktree on a new feature branch, the setup process detects your project name, creates the worktree in a chosen directory, and automatically runs common project setup steps like installing language-specific dependencies.

Git worktrees should be stored in project-local hidden directories like .worktrees or a global fallback location. The setup verifies the chosen path is ignored by Git and updates .gitignore if needed to prevent accidental commits.

Setting up Git worktrees does not require manually updating .gitignore. The setup includes safety verification that checks if the worktree is ignored and automatically updates .gitignore if needed.

The best way to automatically run project setup steps in a new Git worktree is using a setup process that detects project files, creates the worktree on a feature branch, and executes the detected language or tool-specific setup steps.