Skip to content

About

A GitHub Copilot canvas for GitHub notifications, grouped by repository.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

GitHub Notifications

GitHub Copilot: Canvas extension Latest release CI status Line coverage Node.js runtime: >=22

Your GitHub inbox in the GitHub Copilot app, grouped by repository or date, or shown as a single newest-first list. The canvas loads read and unread inbox items; use Filters > Read state to narrow the view. Completed items stay hidden. Search, mark rows or groups as read or done, start a focused Copilot investigation, review, or discussion summary, and opt into desktop notifications or auto-open.

GitHub Notifications canvas with search, a Filters popover control, and attention tabs including Mine, italic mine markers on authored items among ten synthetic notifications, seven unread, across three example repositories, issue, PR and discussion status icons, a failed check run, and fixed Copilot, read, and done columns with summary actions on closed issues, discussions, merged PRs, and releases, a disabled Copilot icon on queued PRs, and dimmed envelopes on already-read rows

Prerequisites

  • A GitHub Copilot app build with extension canvas support (experimental).
  • Node.js 22 or later for the extension runtime and installer.
  • GitHub CLI (gh) available to the app and signed into github.com with notifications or repo scope.
  • Copilot PR, CI, and commit handoffs also require Git 2.29 or later and the configured repository checkout to be accessible on the extension's execution host.

GitHub.com only; fine-grained personal access tokens are not supported. See the installation guide for CLI verification requirements and the sign-in check.

Development tooling requires Node.js 24 or later; this does not change the packaged extension's runtime requirement.

Installation and Updating

Paste this prompt into Copilot:

Install or update the GitHub Notifications canvas as a user-wide Copilot
extension using the latest stable release from:
https://github.com/fletchto99/copilot-notifications-canvas

Follow docs/installation.md in that repository, including all verification
and settings-preservation requirements. Stop if any check fails.
After installation succeeds, reload extensions and open the canvas.

Manual installation and updates cover the full procedure, verification requirements, and troubleshooting.

Usage

  • Find: Filter with attention tabs or search by title, issue/PR number, or repository. Filters combines type, read state, reason, and age, synced across canvases. Search and attention tabs stay local. Mine shows issues, PRs, and discussions you authored.
  • Choose a view: In Settings, group by repository or date, or use one flat list.
  • Read or done: Use the envelope to mark read or the checkmark to mark done. Group headers offer the same actions for loaded tab/search/filter matches.
  • Work with Copilot: Investigate, review, continue, or summarize a supported item. New sessions summarize first and stay read-only until you approve changes; existing sessions open without interruption.
  • Use the keyboard: J/K moves between rows, Enter opens a focused link, I marks read, Shift+E marks done, / focuses search, and ? shows shortcuts.
  • Load more: Include older notifications. Search, counts, and bulk actions cover loaded items only, not your entire inbox.

See Usage for status icons and controls, Copilot actions for supported tasks and confirmations, and Settings for preferences and opt-in desktop alerts.

Privacy

  • Inbox content: Notification titles and repository names are not logged or saved to the extension's files. Ordinary agent actions return counts, not content. There is no telemetry or remote asset loading.
  • Copilot handoffs: The extension sends only the selected GitHub reference and task instructions, not notification titles, bodies, or the surrounding inbox. The reference, instructions, and item details fetched by the destination session are retained in Copilot's session history.
  • Confirmations: Handoffs require a row click; confirmation is on by default. Cloning, inferred CI matches, and existing/new session choices always require confirmation.
  • Desktop alerts: Opt-in alerts share repository names and titles with your OS, which may retain them or show them on the lock screen. Windows and optional macOS terminal-notifier alerts also include a validated GitHub destination URL.
  • Local data: artifacts/ stores settings and desktop coordination data, including timestamps, hashed IDs, process markers, and sanitized errors. Status and authorship are cached only in memory.
  • Credentials and updates: GitHub CLI handles authentication; credentials never enter the renderer. Update checks send no notification content and never download or execute release code.
  • Read/done state: Only explicit Read/Done actions send notification updates. Visiting a linked GitHub page may also mark it read on GitHub.

Documentation

  • Usage: browsing, filtering, Read/Done actions, and keyboard controls.
  • Copilot actions: prompts by notification type, confirmations, and session safeguards.
  • Installation: setup, updates, and verification.
  • Settings: preferences, desktop alerts, and troubleshooting.
  • Development: local development, tests, packaging, and releases.
  • Agent guidance: repository conventions, invariants, and validation.

About

A GitHub Copilot canvas for GitHub notifications, grouped by repository.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages