cc-pr-tracker

Watch GitHub pull requests without leaving your Claude Code session.

Paste a PR URL, or let Claude open one, and it gets one line above the prompt: merge state, review decision and required checks, refreshed every minute by default. When a check flips or the merge state moves you get a toast, a one-second flash and a sound, and Claude gets a note with the failing check's log link. You keep working; the PR tells you when it needs you.

Claude can also ask for a PR's status itself, the list survives restarts, and /config controls what alerts, which checks count, and how often PRs are polled. Where no line can be drawn (claude.ai/code on the web, the Claude mobile app), /prs prints the PRs and every alert is a line in the transcript.

One PR is always one line; hovering it shows its buttons and the details panel names the checks. Reading the line explains each part.

The plugin is a Claude Code mod: a plugin whose TypeScript hooks run inside Claude Code's own process, instead of shell-command hooks. Mods are on by default from Claude Code 2.1.287.

Requirements

• Claude Code 2.1.289 or later for everything (claude --version; mods load by default from 2.1.287). Older builds still watch and alert, but keep the list in memory only, send Claude no note and cannot copy. Before 2.1.287, function hooks were in early access and load only with CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 set; 2.1.287 and later ignore that variable, so remove it if you set it.
• GitHub CLI (gh), logged in with access to the repos you watch. Check with gh auth status. In a claude.ai/code cloud session gh comes set up for the repos the session was given, and since that session refuses GraphQL, polls go over the REST API there (see How it works).
• Optional: macOS for sounds (afplay with the system sounds) and open. On Linux, xdg-open is tried when open is absent, and there is no sound.
• Optional: cmux for pane flashes and workspace notifications. Outside cmux an alert is the toast, the strip, the sound and the note to Claude.

Quick start

1. Install from GitHub. The repo is its own marketplace:

   claude plugin marketplace add sezaakgun/cc-pr-tracker
   claude plugin install cc-pr-tracker@cc-pr-tracker
   

2. Start claude, paste a PR URL as the whole prompt and press Enter. No model turn runs; Claude Code shows Prompt dropped by a hook: watching owner/repo#N. Several URLs at once, separated by spaces or newlines, are all watched.

3. The line appears above the prompt and fills in within a few seconds.

4. Paste the same URL again to stop watching. Run /plugin to confirm the mod loaded: a dim line under the tabs reads N mods active · cc-pr-tracker.

If the line shows gh failed: … instead, see Troubleshooting.

To try it without installing, or to hack on it, clone and load it for one session:

git clone https://github.com/sezaakgun/cc-pr-tracker
cd cc-pr-tracker
claude --plugin-dir .

The repo's own .claude/settings.json still sets CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 for builds before 2.1.287; newer ones ignore it.

Use

On Claude Code 2.1.289 or later the list comes back when you resume a session, Claude is told about changes, and the copy buttons work. Older builds watch and alert as before, in memory only.

• Watch a PR: paste its URL as the whole prompt, several at once if you like. Or mention URLs in a normal prompt: the prompt runs as usual and the PRs are watched too.

• Watch a PR Claude creates or talks about: nothing to do. Any open PR whose URL appears in Claude's answer is watched, and so is the URL gh pr create prints when it runs through the Bash tool. Subagent answers are not scanned.

• Use the line's buttons: hover a line and five buttons appear at its end: open, copy, mute (or unmute), details and ×. They need a terminal that reports the mouse.

• Open a PR: Cmd+click its repo#number (needs a terminal that renders hyperlinks), or hover the line and press open.

• Copy a PR's URL: hover the line and press copy, or press copy URL in the details panel. Over SSH the terminal's clipboard is reached through OSC 52.

• Ask Claude about a PR: Claude has a pr_status tool for the PRs you watch. It polls them when called and answers with the state, merge state, review decision, every required check with its log link and any failing optional check (every optional one with Count all checks on), so "why is my PR red?" needs no gh call. Claude passes a URL or owner/repo#number for one PR, or nothing for all of them; a PR that is not watched gets the list of those that are.

• See every check: hover the line and press details. A side panel shows the title, the state, merge state and review, four buttons (open in browser, copy URL, stop watching, close), then every required check and every failing optional one (every optional one with Count all checks on), linked to its run when the run has an https link. Its last line counts the optional checks and says when the PR was last polled. Esc or close closes the panel and the PR stays watched.

This is the beginning of the README. Read the rest at the original. Read the full README ↗