geogig-branch documentation


geogig branch [<options>] [<branchname> [<startpoint>]] geogig branch –delete <branchname>… geogig branch –rename [–force] [<oldBranchName>] <newBranchName>


With no arguments the command will display all existing branches with the current branch highlighted with the asterisk. The -r option will list only remote branches and the -a option will list both local and remote branches. Adding the –color option with the value of auto, always, or never will add or remove color from the listing. With the -v option it will list the branches along with the commit id and commit message that the branch is currently on.

With a branch name specified it will create a branch of off the current branch. If a start point is specified as well then it will be created off of the given start point. If the -c option is given it will automatically checkout the branch once it is created.

With the -d option with a branch name specified will delete that branch. You cannot delete the branch that you are currently on, checkout a different branch to delete it. Also with the -d option you can list multiple branches for deletion.

With the -m option you can specify an oldBranchName to rename with the given newBranchName or you can rename the current branch by not specifying oldBranchName. With the –force option you can rename a branch to a name that already exists as a branch, however this will delete the other branch.


--color Whether to apply colored output. Possible values are auto|never|always
--checkout, -c Automatically checkout the new branch when the command is used to create a branch
--delete, -d Deletes the specified branch
--rename, -m Rename the current branch if no oldBranchName is specified or the branch called oldBranchName to the newBranchName specified
--force, -f Forces the renaming of a branch to an existing branch and deletes the original branch by that name
--verbose, -v Verbose output for list mode, shows branch commit id and commit message
--remote, -r List or delete (if used with –delete or -D) the remote-tracking branches
--all, -a List all branches, both local and remote



Discussion is still open.

back to top