dolt-branch
List, create, or delete database branches
TLDR
SYNOPSIS
dolt branch [--list] [-v] [-a] [-r]dolt branch [-f] branchname [start-point]dolt branch -m [-f] [oldbranch] newbranchdolt branch -c [-f] [oldbranch] newbranchdolt branch -d [-f] [-r] branchname...
DESCRIPTION
dolt branch lists, creates, or deletes branches in a Dolt database repository. Branches work like Git branches but for versioned databases, allowing parallel development of database schemas and data.Without arguments, the command lists all local branches with an asterisk marking the current branch. Creating a branch captures the current database state as a starting point for divergent development. Note that creating a branch does not switch to it; use dolt checkout to switch branches.Branches can be used for testing schema changes, experimenting with data transformations, or maintaining multiple versions of a dataset.
PARAMETERS
-d, --delete
Delete a branch. The branch must be fully merged unless -f is also given.-D
Shortcut for --delete --force.-m, --move
Rename a branch.-c, --copy
Copy a branch to a new name.-f, --force
Reset a branch to a start point even if it already exists, force rename/copy even if the target name exists, or allow deleting an unmerged branch.-r, --remote
List or operate on remote-tracking branches.-a, --all
List both local and remote-tracking branches.-v, --verbose
Show commit hash and subject line for each branch. Use -vv to also show upstream branch name.-t, --track
Set up upstream tracking for a remote branch.--show-current
Print the name of the current active branch.--list
Explicitly enter list mode.start-point
A commit reference where the new branch should originate. Defaults to the current HEAD.
SEE ALSO
dolt-checkout(1), dolt-merge(1), dolt-commit(1), dolt-status(1), dolt(1)
