STACKITGit/cli
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
load test
253 commits 87 branches 0 tags 160 MiB
Find a file
Nate Smith 52a1575fc1 Update README.md
2019-11-26 10:22:13 -06:00
.github Inject production OAuth client ID+secret into release 2019-11-08 18:57:22 +01:00
.vscode Add VS Code settings 2019-10-07 16:36:23 +02:00
api Merge branch 'checks-crash' 2019-11-20 11:26:16 +01:00
auth Wire up OAuth authentication flow to initialize config file 2019-10-18 19:08:11 +02:00
command Merge pull request #81 from github/pr-status-single-check 2019-11-21 15:27:53 +01:00
context Merge remote-tracking branch 'origin/master' into issue-update 2019-11-18 11:09:00 -08:00
git Merge remote-tracking branch 'origin/master' into issue-update 2019-11-18 11:09:00 -08:00
test Merge remote-tracking branch 'origin/master' into issue-update 2019-11-18 11:09:00 -08:00
ui initial commit 2019-10-03 22:20:31 -05:00
utils Redesign TablePrinter to avoid SetContentWidth / FitColumns steps 2019-11-20 13:29:27 +01:00
.gitignore Configure goreleaser.yml 2019-11-08 18:53:09 +01:00
.goreleaser.yml try out rpm builds 2019-11-22 14:51:25 -06:00
go.mod Merge remote-tracking branch 'origin/master' into issue-update 2019-11-18 11:09:00 -08:00
go.sum Merge remote-tracking branch 'origin/master' into issue-update 2019-11-18 11:09:00 -08:00
main.go Also print cmd usage string on "unknown command" 2019-10-31 22:44:43 +01:00
Makefile Inject production OAuth client ID+secret into release 2019-11-08 18:57:22 +01:00
README.md Update README.md 2019-11-26 10:22:13 -06:00

README.md

gh - The GitHub CLI tool

The #ce-cli team is working on a publicly available CLI tool to reduce the friction between GitHub and one's local machine for people who use the command line primarily to interact with Git and GitHub. https://github.com/github/releases/issues/659

This tool is an endeavor separate from github/hub, which acts as a proxy to git, since our aim is to reimagine from scratch the kind of command line interface to GitHub that would serve our users' interests best.

Installation

warning, gh is in a very alpha phase

macOS

brew install github/gh/gh

Debian/Ubuntu Linux

  1. Download the latest .deb file from the releases page
  2. Install it with sudo dpkg -i gh_0.2.2_linux_amd64.deb, changing version number accordingly

(Uninstall with sudo apt remove gh)

Fedora/Centos Linux

  1. Download the latest .rpm file from the releases page
  2. Install it with sudo yum localinstall gh_0.2.2_linux_amd64.rpm, changing version number accordingly

(Uninstall with sudo yum remove gh)

Other Linux

  1. Download the latest _linux_amd64.tar.gz file from the releases page
  2. tar -xvf gh_0.2.2_linux_amd64.tar.gz, changing version number accordingly
  3. Copy the uncompressed gh somewhere on your $PATH (e.g. sudo cp gh /usr/local/bin/)

(Uninstall with rm)

Process

How to create a release

This can all be done from your local terminal.

  1. git tag 'vVERSION_NUMBER' # example git tag 'v0.0.1'
  2. git push origin vVERSION_NUMBER
  3. Wait a few minutes for the build to run and CI to pass. Look at the actions tab to check the progress.
  4. Go to https://github.com/github/homebrew-gh/releases and look at the release

Test a release

A local release can be created for testing without creating anything official on the release page.

  1. git tag 'v6.6.6' # some throwaway version number
  2. env GH_OAUTH_CLIENT_SECRET=foobar GH_OAUTH_CLIENT_ID=1234 goreleaser --skip-publish --rm-dist
  3. Check and test files in dist/
  4. git tag -d v6.6.6 # delete the throwaway tag