A command-line tool that makes git easier to use with GitHub.
The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:
hub is a command line tool that wraps
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, pleasecontact Support.
$ hub clone rtomayko/tilt #=\> git clone git://github.com/rtomayko/tilt.git # if you prefer HTTPS to git/SSH protocols: $ git config --global hub.protocol https $ hub clone rtomayko/tilt #=\> git clone https://github.com/rtomayko/tilt.git
hub can also be used to make shell scripts that directly interact with the GitHub API.
hub can be safely aliased as
, so you can type
in the shell and have it expanded with
executable has no dependencies, but since it was designed to wrap
, 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
sudo zypper install hub
Void Linux | xbps |
sudo xbps-install -S hub
Gentoo | Portage |
sudo emerge dev-vcs/hub
any | conda |
conda install -c conda-forge hub
Packages other than Homebrew are community-maintained (thank you!) and they are not guaranteed to match the latest hub release. Check
after installing a community package.
can be easily installed as an executable. Download the latest binary for your system and put it anywhere in your executable path.
Note that the default
will only work for API operations scoped to the repository that runs this workflow. If you need to interact with other repositories, generate a Personal Access Token with at least the
scope and add it to your repository secrets.
Prerequisites for building from source are:
Clone this repository and run
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
Some hub features feel best when it's aliased as
. This is not dangerous; your_normal git commands will all work_. hub merely adds some sugar.
displays instructions for the current shell. With the
flag, it outputs a script suitable for
You should place this command in your
or other startup script:
eval "$(hub alias -s)"
If you're using PowerShell, you can set an alias for
by placing the following in your PowerShell profile (usually
Set-Alias git hub
A 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 $PROFILE
hub repository contains tab-completion scripts for bash, zsh and fish. These scripts complement existing completion scripts that ship with git.