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

• approve, quickly approve a PR with a GitHub review
• assignme, assign yourself to a PR
• block, block users on GitHub
• clear-comments, delete all comments on a pull request
• close-prs, close multiple PRs from a certain author targeting a specific branch
• comment, comment on a list of issues / PRs
• contributions, view the number of contributions you've made today
• create, create github repos.
• delete-branches, delete stale branches matching some prefix
• download-release, download the most recent release from a repo
• get-blocks, get the users you've blocked
• greenify, force all statuses on a PR to be gren
• langs, get the language breakdown for a repo
• ls-notifications, list your unread notifications
• me, open your GitHub profile
• notifications, open your unread notifications in the browser
• pr, open a PR from the current branch
• protect, enable/disable branch protection for a specific repo and branch
• unblock, unblock a GitHub user
• unwatch, bulk unwatch repos
• watch, watch a repo

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)