hub 1.12.4

`hub` is a command line utility which adds GitHub knowledge to `git`. It can used on its own or as a `git` wrapper. Normal: $ hub clone rtomayko/tilt Expands to: $ git clone git:// Wrapping `git`: $ git clone rack/rack Expands to: $ git clone git://


Platform: Rubygems

Language: Go

License: MIT


View on registry:


Direct download link:

Install: gem install hub -v 1.12.4

git + hub = github

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://

hub is best aliased as git, so you can type $ git <command> in the shell and get all the usual hub features. See "Aliasing" below.



  • 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.0


hub 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
$ cd hub
$ make install prefix=/usr/local

Prerequisites for compilation are:

  • make
  • Go 1.6+
  • 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/build

You 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


Using 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)"

Shell tab-completion

hub repository contains tab-completion scripts for bash and zsh. These scripts complement existing completion scripts that ship with git.

Installation instructions


Prior art

These projects also aim to either improve git or make interacting with GitHub simpler:


  • 1.12.4 - December 25, 2014 19:45
  • 1.12.3 - November 28, 2014 00:35
  • 1.12.2 - July 11, 2014 19:06
  • 1.12.0 - March 01, 2014 00:11
  • 1.11.2 - February 02, 2014 17:29
  • 1.11.1 - December 26, 2013 00:04
  • 1.11.0 - December 22, 2013 01:16
  • 1.10.6 - April 25, 2013 11:07
  • 1.10.5 - March 02, 2013 05:10
  • 1.10.4 - December 29, 2012 15:39
See all 23 releases

Project Statistics

SourceRank 19
Dependencies 0
Dependent projects 21
Dependent repositories 2.66K
Total releases 23
Latest release
First release
Stars 10.1K
Forks 937
Watchers 219
Contributors 123
Repo Size: 3.62 MB

Top Contributors See all

Jingwen Owen Ou Mislav Marohnić Chris Wanstrath David Calavera pcorpet tgkokk Stephen Celis Justin Weiss Damian Gryski Ivan Tse Yuta Iwama Chris Hoffman Daniel Hahler Matt Windsor Parker Moore Nick LaMuro cornwe19 Jake Zimmerman Jo Liss Ladios Jonquil

Something wrong with this page? Make a suggestion

Export .ABOUT file for this library

Last synced: 2016-11-16 05:05:51 UTC

Login to resync this project