GitHub Pull Requests

A Raycast extension that tracks unread pull request activity across your GitHub or GitHub Enterprise repositories. Never miss a review, comment, or push again.

Features

Unread tracking — Surfaces new reviews, code comments, issue comments, commits, label changes, and force pushes since you last checked.
Multi-repo support — Monitor multiple owner/repo repositories from a single command.
Per-item seen state — Mark individual activity items or entire PRs as read. State persists in Raycast local storage.
Rich detail view — Inline diffs, threaded review conversations, and markdown rendering for every activity type.
Event filters — Toggle which activity types appear (reviews, comments, commits, labels, force pushes, etc.).
Local caching — Cached data displays instantly while a background refresh runs.
Demo mode — Built-in sample data for trying out the extension without a real token.
Menu bar alert — A background command refreshes every 5 minutes and shows how many PRs have unread changes in the macOS menu bar (macOS only). Click a PR to jump straight into it in View Pull Requests.

Setup

Install the extension in Raycast.
Open View Pull Requests and configure the required preferences:

Preference	Description
GH Host	GitHub hostname — defaults to `github.com`; set only for GitHub Enterprise
Personal Access Token	A PAT with `repo` read access
Repositories	Comma-separated `owner/repo` list
Max Unread PRs	Max PRs with unread activity to show (1–1000, default 25)
Max PRs to Scan	Safety cap on PRs fetched while finding unread ones (1–1000, default 150)
Menu Bar Icon	Keep the menu bar icon visible even when everything is read (off by default)
Faster Fetching	Use the GraphQL API — far less API quota on large repos (experimental, off)
Verbose Logging	Detailed console logs for troubleshooting; secrets redacted (off by default)

Usage

Open Raycast and run View Pull Requests. The command shows a list of open PRs sorted by the latest updates.

Select a PR to see a summary of all unseen activity.
Select an activity item to view full detail (diff hunks, conversation threads, review verdicts).
Mark as Read — Use CMD/CTRL + D to mark a single item as read, CMD/CTRL + S to mark an entire PR as read, or mark all PRs as read with CMD/CTRL + Shift + S.
Toggle Event Filters — show/hide specific activity types.

PR Filters

Use GitHub-style search filters to narrow View Pull Requests to a specific set. Click the search-bar dropdown to switch, create, edit, or delete filters.

Supported qualifiers:

assignee:username — PRs assigned to you or a specific user
author:username — PRs opened by you or a specific user
involves:username — PRs where the user commented, reviewed, or was mentioned
review-requested:username — PRs where review is pending from you or a specific user
label:name — PRs with a specific label
draft:true or draft:false — show only drafts or non-drafts
@me — shorthand for your own GitHub login (auto-resolved once per session)

Modifiers:

Negate any qualifier with a leading dash: -author:bot excludes bot-opened PRs
Combine multiple values per qualifier with commas: assignee:alice,bob
Repeat qualifiers: label:bug label:urgent (both labels)
Free-text words search the PR title: ui layout finds PRs with "ui" and "layout" in the title

Filters are saved locally and applied during fetch — they don't waste your Max Unread PRs and Max PRs to Scan budget on excluded pull requests.

Unread PR Alert (menu bar)

Enable the Unread PR Alert command on MacOS to show a menu bar item with the number of PRs that have unread changes. It refreshes automatically every 5 minutes, immediately when you open or refresh View Pull Requests, and whenever you mark items, PRs, or everything as read — so the badge count stays in sync with what you have seen. It shares its data with View Pull Requests, so opening the main command shows already-cached data. Clicking a PR in the dropdown opens View Pull Requests with that PR expanded. The menu bar item disappears if there are no new unread changes.

License

MIT

Versions6

1.3.0 - August 8, 2026

Added

PR Filters — create named, saved filters over View Pull Requests using GitHub-style search qualifiers: assignee:, author:, involves:, review-requested:, label:, and draft:true|false. Any qualifier can be negated with - (e.g. -author:dependabot), combined with commas or repeated for multiple values, and @me resolves to your own GitHub login. Leftover plain words search the PR title.
A dropdown in the search bar lets you switch the active filter instantly; Create Filter…, Edit…, and Delete… actions manage them from the action panel.
The active filter is applied while fetching (both the standard and GraphQL APIs), so it doesn't waste your Max Unread/Scan budget on pull requests it excludes, and the Unread PR Alert menu bar badge always matches whichever filter is active.

1.2.0 - July 30, 2026

Fixed

Unread PR Alert now reads its badge from a synchronous shared cache, so a background refresh can render the current count immediately instead of waiting on an asynchronous read that could resolve after Raycast had already captured the menu bar. This addresses the badge showing a stale count.
Unread PR Alert reuses the main command's freshly fetched data instead of running its own duplicate pull-request scan, reducing the GitHub API requests used when both commands refresh in the same window.
Rate-limit errors now say so. Exhausting your token's hourly quota previously surfaced as a bare "403 Forbidden", which read like a permissions problem; the message now explains the quota, roughly when it resets, and which preferences reduce per-refresh cost.
Failure toasts now carry a Copy Error action.
Corrupt or partially-written local data (cached pull requests, seen state, event filters) is now detected and reset instead of causing a crash on the next launch.

Added

Faster Fetching preference (experimental, off by default) — fetches pull request activity over the GraphQL API, using far less of your hourly GitHub API quota on large repositories. Falls back to the standard API automatically if anything goes wrong.
Menu Bar Icon preference. The icon still appears only when pull requests have unread activity, as before; enable this to keep it visible at all times.
Verbose Logging preference for troubleshooting. Off by default; tokens and other sensitive values are redacted from log output.

Changed

One-time only: label changes and force pushes you had already read may reappear as unread after updating. Their identity is now derived from the event itself rather than an API-assigned id, so read state stays stable across future updates and both fetching modes. Everything else — reviews, comments, and commits — keeps its read state.
The empty state now offers Refresh and Event Filters as its primary actions. Previously the only available action was Demo Mode, and filtering every event type out left no way back.
Action titles use consistent Title Case ("Mark PR as Caught Up").

1.1.1 - July 22, 2026

Added

Optional Max Unread PRs and Max PRs to Scan preferences to tune how many pull requests are surfaced and how far the fetch scans on large repositories (both 1–1000; defaults 25 and 150).

Fixed

The Unread PR Alert badge now refreshes immediately when you open or refresh View Pull Requests and when you mark items, PRs, or everything as read — previously it could stay stale until its next 5-minute interval (most noticeable in the published Store build).
View Pull Requests no longer slows to a crawl or runs out of memory on very large repositories with hundreds of open pull requests.

Changed

The GH Host preference is now optional and defaults to github.com — set it only when using GitHub Enterprise.
The list now surfaces up to a configurable number of pull requests with unread activity (default 25, most-recently-updated first, backfilling past already-seen or filtered PRs) so fetches stay fast on large repositories.

1.1.0 - July 18, 2026

Added

Unread PR Alert menu bar command (macOS) — shows how many pull requests have unread changes as a menu bar badge, refreshing automatically every 5 minutes and hiding when you are all caught up.
The menu bar dropdown lists the 5 most recently updated PRs with unread changes; when there are more, a Show all … item opens the full list.
Selecting a PR in the dropdown opens View Pull Requests with that PR expanded and the rest collapsed.

Changed

View Pull Requests and Unread PR Alert now share the same cached PR data, so opening either command benefits from data already fetched by the other.

1.0.1 - July 9, 2026

Changed

Renamed extension and command title from "GitHub PR Tracker" / "My PR Updates" to "GitHub Pull Requests" / "View Pull Requests".
Updated package.json description and command subtitle/description to match the new naming.
Updated README.md to reflect the new extension/command names, simplified the preferences table, updated usage instructions with keyboard shortcuts, and removed the development section.

Fixed

Changed the "Mark All as Caught up" keyboard shortcut from the reserved Duplicate shortcut to Cmd+Shift+S (macOS) / Ctrl+Shift+S (Windows) to avoid conflicting with a "Mark This Item as Seen" shortcut.

Initial Release - July 9, 2026

Added

Initial release of the GitHub Pull Requests extension.
My PR Updates command — lists open PRs with unseen activity across configured repositories.
Tracks reviews, code comments, issue comments, commits, label changes, force pushes, and new PR events.
Per-item and per-PR seen/unread state persisted in Raycast local storage.
Rich detail view with inline diffs, threaded review conversations, and markdown rendering.
Event type filters (toggle reviews, comments, commits, labels, etc.).
Local caching for instant display with background refresh.
Demo mode with sample data for trying the extension without a PAT.
Paginated GitHub API fetching with proper error handling.
Support for GitHub Enterprise via configurable host preference.

Fixed

Removed unnecessary node-fetch dependency — uses built-in fetch.
Removed manual Preferences interface in favor of auto-generated types from raycast-env.d.ts.
HTTP errors in paginated API calls now throw with status details instead of silently returning partial data.
Added $schema and categories fields to package.json for Raycast store compatibility.
Migrated ESLint configuration from legacy .eslintrc.json to flat config (eslint.config.mjs) with ESLint v9.

Contributors1

chrismessina

Compatibility

macOS
Windows

GitHub Pull Requests

A Raycast extension that tracks unread pull request activity across your GitHub or GitHub Enterprise repositories. Never miss a review, comment, or push again.

Features

Unread tracking — Surfaces new reviews, code comments, issue comments, commits, label changes, and force pushes since you last checked.
Multi-repo support — Monitor multiple owner/repo repositories from a single command.
Per-item seen state — Mark individual activity items or entire PRs as read. State persists in Raycast local storage.
Rich detail view — Inline diffs, threaded review conversations, and markdown rendering for every activity type.
Event filters — Toggle which activity types appear (reviews, comments, commits, labels, force pushes, etc.).
Local caching — Cached data displays instantly while a background refresh runs.
Demo mode — Built-in sample data for trying out the extension without a real token.
Menu bar alert — A background command refreshes every 5 minutes and shows how many PRs have unread changes in the macOS menu bar (macOS only). Click a PR to jump straight into it in View Pull Requests.

Setup

Install the extension in Raycast.
Open View Pull Requests and configure the required preferences:

Preference	Description
GH Host	GitHub hostname — defaults to `github.com`; set only for GitHub Enterprise
Personal Access Token	A PAT with `repo` read access
Repositories	Comma-separated `owner/repo` list
Max Unread PRs	Max PRs with unread activity to show (1–1000, default 25)
Max PRs to Scan	Safety cap on PRs fetched while finding unread ones (1–1000, default 150)
Menu Bar Icon	Keep the menu bar icon visible even when everything is read (off by default)
Faster Fetching	Use the GraphQL API — far less API quota on large repos (experimental, off)
Verbose Logging	Detailed console logs for troubleshooting; secrets redacted (off by default)