You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Click the toolbar icon to go to the GitHub notifications page.
Option to show only unread count for issues you're participating in.
Make sure to add a token in the options.
Screenshots
Options
Notification Count
GitHub Token Setup
Token Types Supported
This extension requires a GitHub personal access token to function properly. You can follow instructions from GitHub to create a personal access token in your account.
Important: Only classic personal access tokens are currently supported. Fine-grained personal access tokens cannot be used at this time. This limitation is tracked in an open issue.
Repository Permissions
For Private Repository Notifications
To receive desktop notifications for private repositories, you must create a personal access token with the repo scope. This requirement exists because of GitHub's current permission structure - accessing any information about private repositories requires full repository control permissions.
Security Considerations
If you have security concerns about granting the repo scope, you can skip this permission. However, be aware of the following tradeoff:
Without repo scope: Clicking on notifications will redirect you to the general notifications homepage instead of the specific repository or issue
With repo scope: Clicking on notifications will take you directly to the relevant repository content
The choice between security and functionality is yours based on your comfort level with the permissions required.
Extension Permissions
The extension requests a couple of optional permissions. It works as intended even if you disallow these. Some features work only when you grant these permissions as mentioned below.
Tabs Permission
When you click on the extension icon, the GitHub notifications page is opened in a new tab. The tabs permission lets us switch to an existing notifications tab if you already have one opened instead of opening a new one each time you click it.
This permission also lets us update the notification count immediately after opening a notification. You can find both of these options under the "Tab handling" section in the extension's options page.
Notifications Permission
If you want to receive desktop notifications for public repositories, you can enable them on extension options page. You will then be asked for the notifications permission.
Configuration
Desktop Notifications
You can opt-in to receive desktop notifications for new notifications on GitHub. The extension checks for new notifications every minute, and displays notifications that arrived after the last check if there are any. Clicking on the notification opens it on GitHub.
Filtering Notifications
If you have desktop notifications enabled as mentioned above, you can also filter which repositories you wish to receive these notifications from. You can do this by only selecting the repositories (that grouped by user/organization) in the options menu.
GitHub Enterprise support
By default, the extension works for the public GitHub site. If the repo of your company runs GitHub on their own servers via GitHub Enterprise Server, you have to configure the extension to use the API URL. For example https://github.yourco.com/.