Home

Awesome

ghb

This is a small set of scripts for working with github. Unlike hub or gh the purpose of this is not to override git and add functionality on top of that. Instead this uses a git like method of looking for executables named ghb-* and nesting them under the ghb command. This allows you to create simple single purpose scripts in any language.

Commands

See the header comment in each individual file for specific usage.

Installation

brew install keith/formulae/ghb

Or:

pip install ghb

(and install zsh/_ghb if you want zsh completions)

Configuration

To setup authentication for ghb you must add a personal access token to your ~/.netrc file. You can generate a token here. You should enable the repo, workflow, notifications, and user scopes (you maybe be able to omit some of those depending on which subcommands you plan to use).

Then in your ~/.netrc file add:

machine api.github.com
login GITHUB_USERNAME
password TOKEN

And restrict permissions with chmod 0600 ~/.netrc (this is required)