daft go

Open an existing branch in a worktree

Usage

daft go [OPTIONS] <BRANCH_NAME>

Description

Creates a new worktree for an existing local or remote branch. The worktree is placed at the project root level as a sibling to other worktrees, using the branch name as the directory name.

If the branch exists only on the remote, a local tracking branch is created automatically. If a worktree for the branch already exists, the working directory is changed to it.

With --start (or -s), if the branch does not exist locally or on the remote, a new branch and worktree are created automatically. This can also be enabled permanently with git config daft.go.autoStart true.

Previous worktree (-)

Use - as the branch name to switch to the previous worktree, similar to cd -. Each successful daft go or daft start records the source worktree, so repeated daft go - toggles between the two most recent worktrees.

daft go main        # switch to main
daft go feature/x   # switch to feature/x (main is now "previous")
daft go -           # back to main
daft go -           # back to feature/x

Cannot be combined with -b/--create-branch.

Arguments

Argument	Description	Required
<BRANCH_NAME>	Name of the branch to check out; use - for previous worktree	Yes

Options

Option	Description	Default
-s, --start	Create a new worktree if the branch does not exist
-x, --exec <EXEC>	Run a command in the worktree after setup (repeatable)
--no-cd	Do not change directory to the new worktree
-c, --carry	Apply uncommitted changes from the current worktree
--no-carry	Do not carry uncommitted changes
-r, --remote <REMOTE>	Remote for worktree organization (multi-remote mode)
-v, --verbose	Be verbose; show detailed progress
-q, --quiet	Suppress non-error output

Global Options

Option	Description
-h, --help	Print help information
-V, --version	Print version information

Examples

# Check out an existing branch
daft go feature/auth

# Switch to the previous worktree (toggle)
daft go -

# Check out a branch, auto-creating if it doesn't exist
daft go -s feature/new-idea

# Check out and run a command after setup
daft go feature/auth -x 'npm install'

# Check out without changing directory
daft go feature/auth --no-cd

See Also

• daft start to create a new branch
• git worktree-checkout for the underlying git-native command