hub helps you win at git. http://hub.github.com/
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.Installation
Dependencies:
- git 1.7.3 or newer
Homebrew
hub
can be installed through Homebrew:$ brew install hub
$ hub version
git version 1.7.6
hub version 2.2.3
If you want to get access to new
hub
features earlier and help with its development by reporting bugs, you can install the prerelease version:$ brew install --devel hub
Chocolatey
hub
can be installed through Chocolatey on Windows.> choco install hub
> hub version
git version 2.7.1.windows.2
hub version 2.2.3
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
Standalone
hub
can be easily installed as an executable. Download the latest compiled binaries and put it anywhere in your executable path.Source
To install hub from source:
$ git clone https://github.com/github/hub.git
$ cd hub
$ make install prefix=/usr/local
Prerequisites for compilation are:
make
- Go 1.8+
- 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 github.com/github/hub
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 and zsh. These scripts complement existing completion scripts that ship with git.
Meta
- Home: https://github.com/github/hub
- Bugs: https://github.com/github/hub/issues
- Authors: https://github.com/github/hub/contributors
from https://github.com/github/hub/
No comments:
Post a Comment