Go Gherkin Shell Ruby Other
Latest commit c60ca20 Aug 7, 2018
Permalink
Failed to load latest commit information.
.ctags.d Rename `ctags` file for compatibility with universal-ctags Jun 6, 2018
cmd Avoid `copy` when making a subslice May 29, 2018
commands Fix `hub init -g` documentation Jul 16, 2018
coverage Measure code coverage between tests Jun 7, 2018
etc Have `ci-status` also query Checks API Jul 7, 2018
features Have `ci-status` also query Checks API Jul 7, 2018
fixtures fmt Jun 11, 2018
git No commit signature in default pull request message Jan 29, 2018
github Have `ci-status` also query Checks API Jul 7, 2018
script Test install script in CI Jun 14, 2018
share/man/man1 Fix `hub init -g` documentation Jul 16, 2018
ui spelling: indicate Nov 8, 2017
utils Add relative date format to `issue` output Aug 16, 2016
vendor Migrate from gopkg.in/yaml.v1 to gopkg.in/yaml.v2 Jun 15, 2018
version hub 2.5.0 Jul 7, 2018
.agignore Ignore `bundle/` directory when searching Feb 21, 2018
.gitattributes Enforce unix eol in bash script files Sep 2, 2017
.gitignore Avoid `dep` clashing with Bundler Jan 29, 2018
.travis.yml Avoid running `publish-release` multiple times per tag Jun 7, 2018
CODE_OF_CONDUCT.md Improve contact email, part 2 Aug 28, 2017
CONTRIBUTING.md docs: remove explicit reference to name of obsolete code of conduct i… Aug 6, 2018
Gemfile Include all man pages in packaged releases Jan 25, 2016
Gemfile.lock Update Sinatra for Ruby 2.4 compatibility Jun 8, 2018
Gopkg.lock Migrate from gopkg.in/yaml.v1 to gopkg.in/yaml.v2 Jun 15, 2018
Gopkg.toml Migrate from gopkg.in/yaml.v1 to gopkg.in/yaml.v2 Jun 15, 2018
LICENSE MIT Dec 8, 2009
Makefile Remove obsolete build steps Jun 8, 2018
README.md Remove instructions about Chocolatey on Windows Jul 7, 2018
Vagrantfile Use Go 1.4.2 Apr 12, 2015
cucumber.yml Detect tmux and run shell completion tests Nov 14, 2013
main.go Enforce go1.8+ via build flags too May 17, 2017

README.md

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://github.com/rtomayko/tilt.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.

See Usage documentation for the list of all commands and their arguments.

Installation

Dependencies:

  • git 1.7.3 or newer

Homebrew

hub can be installed through Homebrew on macOS:

$ 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

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 official repository:

$ sudo pacman -S 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:

$ go get github.com/github/hub
$ cd "$GOPATH"/src/github.com/github/hub
$ make install prefix=/usr/local

Prerequisites for compilation are:

  • make
  • Go 1.8+
  • Ruby 1.9+ with Bundler - for generating man pages

Aliasing

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

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.

Installation instructions

Meta