git-create-branch - Man Page

Create branches

Examples (TL;DR)

Create a local branch: git create-branch branch_name
Create a branch locally and on origin: git create-branch --remote branch_name
Create a branch locally and on upstream (through forks): git create-branch --remote upstream branch_name

tldr.sh

Synopsis

git-create-branch [-r|--remote [remote_name]] <branchname>

Description

Creates local branch named <branchname> and optionally sets up a remote tracking branch.

Options

<-r|--remote [remote_name]>

Setup a remote tracking branch using remote_name. If remote_name is not supplied, use origin by default.

<--from [start_point]>

Setup a start point when the branch created. If --from is not supplied, use the current branch by default.

The name of the branch to create.

You may save your default preference for the remote option above by using git config with the key git-extras.create-branch.remote whose value will be the default remote when [-r|--remote] is not specified.

$ git config git-extras.create-branch.remote lucinda

The command line option -r|--remote will override this preference.

Examples

With no remote preference set:

# creates local branch ´integration´
$ git create-branch integration

# creates local & remote branch ´integration´ (on default ´origin´)
$ git create-branch -r integration

# creates local & remote branch ´integration´ on ´upstream´
$ git create-branch -r upstream integration

With git-extras.create-branch.remote preference set to ´lucinda´:

# creates local & remote branch ´integration´ (on preference ´lucinda´)
$ git create-branch integration

# overriding preference, using default `-r` of ´origin´
# creates local & remote branch ´integration´ on default ´origin´
$ git create-branch -r integration

# overriding preference, using specified `-r` of ´upstream´
# creates local & remote branch ´integration´ on ´upstream´
$ git create-branch -r upstream integration

Notes

As of 4.4.0, the default behavior has changed. git-create-branch will no longer automatically setup a remote tracking branch unless the -r|-remote option is specified. See additional note on preference feature in 4.8.0-dev below.
As of 4.8.0-dev, the remote option can be set via git config preference as described in Preferences section.