git-create-branch
- Create branches
git-create-branch
[-r|--remote [remote_name]] <branchname>
Creates local branch named <branchname> and optionally sets up a remote tracking branch.
<-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.
<branchname>
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.
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
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.
Written by Jonhnny Weslley <jw@jonhnnyweslley.net> Modified by Mark Pitman <mark.pitman@gmail.com>, Brian Murrell <btmurrell@gmail.com>.
<https://github.com/tj/git-extras/issues>
<https://github.com/tj/git-extras>