4.2 KiB
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
hub can be safely aliased as git so you can type $ git <command> 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
The hub 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.
Homebrew
hub can be installed through Homebrew/Linuxbrew:
$ brew install hub
$ hub version
git version 1.7.6
hub version 2.2.3
Windows
hub can be installed through Scoop on Windows:
> scoop install hub
or alternatively hub can be installed through Chocolatey:
> choco install hub
Fedora Linux
On Fedora you can install hub through DNF:
$ sudo dnf install hub
$ hub version
git version 2.9.3
hub version 2.2.9
Arch Linux
On Arch Linux you can install hub from the official repository:
$ sudo pacman -S hub
FreeBSD
On FreeBSD you can install a prebuilt hub package with
pkg(8):
# pkg install hub
Debian
On Debian (versions sid and buster) you can install hub from the official repository:
$ sudo apt install hub
Standalone
hub can be easily installed as an executable. Download the latest
compiled binaries and put it anywhere
in your executable path.
Source
With your GOPATH already set up:
mkdir -p "$GOPATH"/src/github.com/github
git clone \
--config transfer.fsckobjects=false \
--config receive.fsckobjects=false \
--config fetch.fsckobjects=false \
https://github.com/github/hub.git "$GOPATH"/src/github.com/github/hub
cd "$GOPATH"/src/github.com/github/hub
make install prefix=/usr/local
Prerequisites for compilation are:
make- Go 1.9+
Aliasing
Some hub features feel 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)"
PowerShell
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 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
Shell tab-completion
hub repository contains tab-completion scripts for bash, zsh and fish. These scripts complement existing completion scripts that ship with git.