A command-line tool that makes git easier to use with GitHub. https://hub.github.com/
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.This repository and its issue tracker is not for reporting problems with GitHub.com web interface. If you have a problem with GitHub itself, please contact Support.
Usage
$ hub clone rtomayko/tilt
# expands to:
#=> git clone git://github.com/rtomayko/tilt.git
git
so you can type $ git
in the shell and get all the usual hub
features.See Usage documentation for the list of all commands and their arguments.
hub can also be used to make shell scripts that manually interface with the GitHub API.
Installation
Thehub
executable has no dependencies, but since it was designed to wrap git
, it's recommended to have at least git 1.7.3 or newer.platform | manager | command to run |
---|---|---|
macOS, Linux | Homebrew | brew install hub |
Windows | Scoop | scoop install hub |
Windows | Chocolatey | choco install hub |
Fedora Linux | DNF | sudo dnf install hub |
Arch Linux | pacman | sudo pacman -S hub |
FreeBSD | pkg(8) | pkg install hub |
Debian | apt(8) | sudo apt install hub |
Ubuntu | Snap | snap install hub --classic |
Standalone
hub
can be easily installed as an executable. Download the latest compiled binaries and put it anywhere in your executable path.Source
Prerequisites for building from source are:make
- Go 1.9+
make install
:git clone \
--config transfer.fsckobjects=false \
--config receive.fsckobjects=false \
--config fetch.fsckobjects=false \
https://github.com/github/hub.git
cd hub
make install prefix=/usr/local
$GOPATH/src/github.com/github/hub
.Aliasing
Some hub features feel best when it's aliased asgit
. 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)"
PowerShell
If you're using PowerShell, you can set an alias forhub
by placing the following in your PowerShell profile (usually ~/Documents/WindowsPowerShell/Microsoft.PowerShell_profile.ps1
):Set-Alias git hub
Add-Content $PROFILE"`nSet-Alias git hub"
If your PowerShell profile doesn't exist, you can create it by running the following:
New-Item -Type file -Force $PROFILE
Shell tab-completion
hub repository contains tab-completion scripts for bash, zsh and fish. These scripts complement existing completion scripts that ship with git.Installation instructions