Ghn
List/Open unread GitHub Notifications.
Installation
$ gem install ghn
Usage
$ ghn help
Commands:
ghn help [COMMAND] # Describe available commands or one specific command
ghn list NAME # List unread notifications
ghn open NAME # Open unread notifications in browser
Options:
-a, [--all], [--no-all] # List/Open all unread notifications
-p, [--participating], [--no-participating] # List/Open notifications your are participating
[--follow-issuecomment], [--no-follow-issuecomment] # Follow issuecomment anchor URL
-s, [--sort], [--no-sort] # Sort notifications by url
NAME should be a username/reponame of repository.
$ ghn list
displays first 50 unread notifications to STDOUT.
$ ghn open rails/rails
opens first 50 unread notifications of rails/rails in your browser.
$ ghn open -a
opens all unread notifications in your browser.
$ ghn open -p
opens notifications your are participating only.
$ ghn open -s
opens notifications sorted by url.
Aliases
You can set aliases as a shortcut of NAME.
Aliases should be stored to your global .gitconfig
file.
$ git config --global ghn.alias.play playframework/playframework
Now $ ghn open play
opens unread notifications of playframework/playframework in your browser.
NOTE: aliases must have ghn.alias namespace.
Authentication
Please set ghn.token to your .gitconfig
.
$ git config --global ghn.token [Your GitHub access token]
You can also set access token via GHN_ACCESS_TOKEN
environment variable.
Follow issuecomment anchor
If you provide --follow-issuecomment
option, or set git config ghn.followissuecomment
to "yes", "on" or "true",
ghn follows #issuecomment- anchor URL as like GitHub's official notification link.
$ ghn open --follow-issuecomment
$ git config --global ghn.followissuecomment true
Commandline option overrides git config setting as well.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request