README

This tool aims to provide support for common git/GitHub functionality and evolves from being a simple mergetool to provide handy shortcuts to frequently used commands.

gh expects an composer.json with a valid name in the git root directory. If you do not have a composer.json and you are executing GitHub related commands like the merge command you need to specify the username and the repository.

gh also expects by convention a remote with the organization name. If such does not exist gh creates one when a command needs it.

Start with

./gh configure

to setup your GitHub token.

Afterwards use ./gh to get an overview over the available functions.

Installation

gh can be installed via composer.

    composer global require 'peterrehm/gh=dev-master'

Make sure you have defined the following export path as well:

    export PATH=~/.composer/vendor/bin:$PATH

When using Zsh the export path in .zshrc must be updated. Also you should use the complete path instead of ~/.