Forrest logo
back to the git tool

git-worktree:tldr:2b1f7

git-worktree: Create a new directory with a new branch checked out into it.
$ git worktree add ${path-to-directory} -b ${new_branch}
try on your machine

The command git worktree add ${path-to-directory} -b ${new_branch} is used to create a new working tree from a specific branch in a Git repository.

Here's a breakdown of the command:

  • git: This is the command-line tool for version control, indicating that we are using Git.
  • worktree: This is a subcommand in Git used to manage multiple working trees in a single repository.
  • add: This subcommand is used to create a new working tree.
  • ${path-to-directory}: It should be replaced with the actual path where you want to create the new working tree. For example, ./new_worktree specifies a directory named "new_worktree" in the current directory.
  • -b: This option is used to specify that a new branch should be created for the new working tree.
  • ${new_branch}: It should be replaced with the name of the new branch. For example, feature/new_branch specifies a branch named "new_branch" under the "feature" namespace.

So, running this command will create a new working tree in the specified directory and switch to a newly created branch in that working tree.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.
back to the git tool