hub is a command line tool that wraps git in order to extend it with extra
features and commands that make working with GitHub easier.
$ hub clone rtomayko/tilt
# expands to:
$ git clone git:https://github.com/rtomayko/tilt.github is best aliased as git, so you can type $ git <command> in the shell and
get all the usual hub features. See "Aliasing" below.
Dependencies:
- git 1.7.3 or newer
hub can be installed through Homebrew:
$ brew install hub
$ hub version
git version 1.7.6
hub version 2.2.3If you want to get access to new hub features earlier and help with its
development by reporting bugs, you can install the prerelease version:
$ brew install --devel hubhub can be installed through Chocolatey on Windows.
> choco install hub
> hub version
git version 2.7.1.windows.2
hub version 2.2.3On Fedora you can install hub through DNF:
$ sudo dnf install hub
$ hub version
git version 2.9.3
hub version 2.2.9hub can be easily installed as an executable. Download the latest
compiled binaries and put it anywhere
in your executable path.
To install hub from source:
$ git clone https://github.com/github/hub.git
$ cd hub
$ make install prefix=/usr/localPrerequisites for compilation are:
make- Go 1.8+
- Ruby 1.9+ with Bundler - for generating man pages
If you don't have make, Ruby, or want to skip man pages (for example, if you
are on Windows), you can build only the hub binary:
$ ./script/buildYou can now move bin/hub to somewhere in your PATH.
Finally, if you've done Go development before and your $GOPATH/bin directory
is already in your PATH, this is an alternative installation method that fetches
hub into your GOPATH and builds it automatically:
$ go get github.com/github/hubUsing hub feels best when it's aliased as git. This is not dangerous; your
normal git commands will all work. hub merely adds some sugar.
hub alias displays instructions for the current shell. With the -s flag, it
outputs a script suitable for eval.
You should place this command in your .bash_profile or other startup script:
eval "$(hub alias -s)"If you're using PowerShell, you can set an alias for hub by placing the
following in your PowerShell profile (usually
~/Documents/WindowsPowerShell/Microsoft.PowerShell_profile.ps1):
Set-Alias git hubA simple way to do this is to run the following from the PowerShell prompt:
Add-Content $PROFILE "`nSet-Alias git hub"Note: You'll need to restart your PowerShell console in order for the changes to be picked up.
If your PowerShell profile doesn't exist, you can create it by running the following:
New-Item -Type file -Force $PROFILEhub repository contains tab-completion scripts for bash and zsh. These scripts complement existing completion scripts that ship with git.