GNOME GitHub Notifications

A GNOME Shell extension that displays GitHub notifications in the top panel.

Features

• Shows unread GitHub notification count in the panel
• Groups notifications by repository in a dropdown menu (up to 25 items)
• Click a notification to open it in the browser
• Desktop alerts for new notifications
• Filters: participating only, review requests, mentions, assignments
• Respects GitHub's rate limiting and poll interval headers
• Exponential backoff on errors
• Network connectivity awareness
• Optional debug logging

Requirements

• GNOME Shell 46, 47, 48, or 49
• A GitHub personal access token with notifications scope

Installation

The extension is not yet available on extensions.gnome.org. Install it manually by cloning directly into the GNOME extensions directory:

git clone https://github.com/widoz/gnome-github-notifications \
  ~/.local/share/gnome-shell/extensions/github-notifications@widoz.github.io
gnome-extensions enable github-notifications@widoz.github.io

On Wayland, log out and back in after enabling. On X11, press Alt+F2, type r, and press Enter.

Configuration

Open the extension preferences (via GNOME Extensions app or Settings > Extensions):

• GitHub Token — personal access token with notifications scope
• Refresh Interval — polling interval in seconds (30–600)
• Show Participating Only — only show notifications you are participating in
• Alert Notifications — show desktop alerts for new notifications
• Notify on Review Requests / Mentions / Assignments — filter notification types

Development

After making changes to the schema XML, recompile it:

glib-compile-schemas schemas/

See CLAUDE.md for full architecture notes.

License

GPL-2.0-or-later — see LICENSE.