List/Open unread GitHub Notifications. View on GitHub


Build Status

List/Open unread GitHub Notifications.


$ gem install ghn


$ ghn help
  ghn help [COMMAND]  # Describe available commands or one specific command
  ghn list NAME       # List unread notifications
  ghn open NAME       # Open unread notifications in browser

  -a, [--all], [--no-all]  # List/Open all unread notifications

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.


You can set aliases as a shortcut of NAME. Aliases should be stored to your global .gitconfig file.

$ git config --global playframework/playframework

Now $ ghn open play opens unread notifications of playframework/playframework in your browser.

NOTE: aliases must have ghn.alias namespace.


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.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request