Fast GitHub command line client. Current version is 0.6.0.
gh is a command line client to GitHub. It's designed to run as fast as possible with easy installation across operating systems. If you like gh, please also take a look at hub. Hub is a reference implementation to gh.
Fast
$ time hub version > /dev/null
hub version > /dev/null 0.03s user 0.01s system 93% cpu 0.047 total
$ time gh version > /dev/null
gh version > /dev/null 0.01s user 0.01s system 85% cpu 0.022 total
$ time hub browse > /dev/null
hub browse > /dev/null 0.07s user 0.04s system 87% cpu 0.130 total
$ time gh browse > /dev/null
gh browse > /dev/null 0.03s user 0.02s system 87% cpu 0.059 total
Muti-platforms
gh is fully implemented in the Go language and is designed to run across operating systems.
Easy installation
There're no pre-requirements to run gh. Download the binary and go!
Unix
gh commands are single, unhyphenated words that map to their Unix ancestors’ names and flags where applicable.
There are compiled binary forms of gh for Darwin, Linux and Windows.
To install gh on OSX with Homebrew, run:
$ brew install https://raw.github.com/jingweno/gh/master/homebrew/gh.rb
To compile gh from source, you need to have a Go development environment and run:
$ go get github.com/jingweno/gh
Note that go get will pull down sources from various VCS.
Please make sure you have git and hg installed.
Since gh is under heavy development, I roll out new releases often. Please take a look at the CI server for the latest built binaries. I plan to implement automatic upgrade in the future.
To upgrade gh on OSX with Homebrew, run:
$ brew upgrade https://raw.github.com/jingweno/gh/master/homebrew/gh.rb
To upgrade gh from source, run:
$ go get -u github.com/jingweno/gh
$ gh help
Usage: gh [command] [options] [arguments]
Commands:
pull Open a pull request on GitHub
fork Make a fork of a remote repository on GitHub and add as remote
ci Show CI status of a commit
browse Open a GitHub page in the default browser
compare Open a compare page on GitHub
help Show help
version Show gh version
See 'gh help [command]' for more information about a command.
# while on a topic branch called "feature":
$ gh pull
[ opens text editor to edit title & body for the request ]
[ opened pull request on GitHub for "YOUR_USER:feature" ]
# explicit pull base & head:
$ gh pull -b jingweno:master -h jingweno:feature
$ gh pull -i 123
[ attached pull request to issue #123 ]
$ gh fork
[ repo forked on GitHub ]
> git remote add -f YOUR_USER git@github.com:YOUR_USER/CURRENT_REPO.git
$ gh fork --no-remote
[ repo forked on GitHub ]
$ gh ci
> (prints CI state of HEAD and exits with appropriate code)
> One of: success (0), error (1), failure (1), pending (2), no
> status (3)
$ gh ci BRANCH
> (prints CI state of BRANCH and exits with appropriate code)
> One of: success (0), error (1), failure (1), pending (2), no
> status (3)
$ gh ci SHA
> (prints CI state of SHA and exits with appropriate code)
> One of: success (0), error (1), failure (1), pending (2), no
> status (3)
gh browse
> open https://github.com/YOUR_USER/CURRENT_REPO
$ gh browse commit/SHA
> open https://github.com/YOUR_USER/CURRENT_REPO/commit/SHA
$ gh browse issues
> open https://github.com/YOUR_USER/CURRENT_REPO/issues
$ gh browse -u jingweno -r gh
> open https://github.com/jingweno/gh
$ gh browse -u jingweno -r gh commit/SHA
> open https://github.com/jingweno/gh/commit/SHA
$ git browse -r resque
> open https://github.com/YOUR_USER/resque
$ git browse -r resque network
> open https://github.com/YOUR_USER/resque/network
$ gh compare refactor
> open https://github.com/CURRENT_REPO/compare/refactor
$ gh compare 1.0..1.1
> open https://github.com/CURRENT_REPO/compare/1.0...1.1
$ gh compare -u other-user patch
> open https://github.com/other-user/REPO/compare/patch
- 0.6.0 June 11, 2013
- Implement
fork
- Implement
- 0.5.2 June 8, 2013
- Extract GitHub API related code to
octokat
- Extract GitHub API related code to
- 0.5.1 June 7, 2013
- Remove
-pflag frombrowse
- Remove
- 0.5.0 June 5, 2013
- Rename
pull-requesttopull - Rename
ci-statustoci
- Rename
- 0.4.1 June 2, 2013
- Add Rake task to bump version
- 0.4.0 June 2, 2013
- Implement
compare - Fix bugs on
browse
- Implement
- 0.0.3 June 1, 2013
- Implement
browse
- Implement
- 0.0.2 May 29, 2013
- Implement
ci
- Implement
- 0.0.1 May 22, 2013
- Implement
pull-request
- Implement
- authentication (done)
- gh pull-request (done)
- gh ci-status (done)
- gh browse (done)
- gh compare (done)
- gh fork (done)
- gh clone (in progress)
- gh remote add
- gh fetch
- gh cherry-pick
- gh am, gh apply
- gh check
- gh merge
- gh create
- gh init
- gh push
- gh submodule
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request
gh is released under the MIT license. See LICENSE.md.