/ghn

List/Open unread GitHub Notifications.

Primary LanguageRubyMIT LicenseMIT

Ghn

Build Status

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

  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