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.
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 ~/.