gitty is a smart little CLI helper for git projects, that shows you all the relevant issues, pull requests and changes at a quick glance. It currently only supports the GitHub API, but I’d eventually like it to become a bit more agnostic.
- Binaries for Linux, FreeBSD, OpenBSD, macOS, Windows
Make sure you have a working Go environment (Go 1.12 or higher is required). See the install instructions.
Compiling gitty is easy, simply run:
git clone https://github.com/muesli/gitty.git cd gitty go build
Note: In order to access GitHub’s API,
gitty requires you to provide a valid GitHub token in an environment variable called either
GITTY_TOKEN. You can create a new token in your profile settings:
Developer settings >
Personal access tokens >
Generate new token
Make sure to enable the
read:org permissions in particular.
You can start
gitty with either a path or a GitHub URL as an argument. If no argument was provided,
gitty will operate on the current working directory.
The following flags are supported:
-max-branch-age int Max age of a branch in days to be considered active (default 28) -max-branches int Max amount of active branches to show (default 10) -max-commits int Max amount of commits to show (default 10) -max-issues int Max amount of issues to show (default 10) -max-pull-requests int Max amount of pull requests to show (default 10)
Open issue or pull request in browser
If you launch
gitty with the ID of an issue or pull request, it will open the issue or pull request in your browser:
gitty /some/repo 42