gh is a minimal alternative to GitHub CLI. It allows you to rapidly open the repository page, list PRs waiting for review, open new PRs, etc.
# Opens the repository page
$ gh
# Opens the pull request page of the current repository
$ gh pulls
# Opens the pull request page, but only your closed PRs are listed
$ gh pulls --closed \
--author=@me
# Opens the pull request page, but only PRs awaiting review from you are listed
$ gh pulls --to-review
# Opens the pull request form filling some fields
$ gh newpr --dest-src=main..my-branch \
--template=feature.md \
--title=I implemented a very nice feature \
--assignees=gustavothecoder \
--labels=feature,minorYou need to be able to compile C code. Installing build-essential for Debian-based distros or base-devel for Arch-based distros should be sufficient.
gh uses libprompt to handle CLI prompts, so you need to install it.
Right now FireFox is a dependency too.
Just run:
$ make installTo uninstall:
$ make uninstallRun gh help or read the manpage right here.
You can use gh to create cool scripts, like this one:
bugpr() {
current_branch=$(git branch 2> /dev/null | sed -e '/^[^*]/d' -e 's/* \(.*\)/\1/')
gh newpr \
--dest-src=main...$current_branch \
--template=bug.md \
--assignees=gustavothecoder \
--labels=bug,patch \
--title="$1"
}
bugpr "This PR fix a critical bug"
Bug reports and pull requests are welcome :)