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.
- 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 withnotificationsorreposcope. - 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.
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.
- 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.
- 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-notifieralerts 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.
- 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.
