pr-watch

A Claude Code mod that keeps a live pane of the GitHub pull requests a session touches: CI, review, conflicts, merge. You see when the PR Claude opened goes green, gets a review or hits a conflict, without asking.

╭──────────────────────────────────────────────╮
│  ● CI RUNNING                       acme/app │
│ #12 Retry uploads with exponential backoff   │
│ feat/retry → main  +120 −14  @octocat        │
│                                              │
│ ✓ Open ━━━━━━ ⠹ CI ┈┈┈┈┈┈ ○ Review ┈┈ ○ Merge │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1/3  │
│ Running build · 1 queued · 1/3 passed        │
│ open ↗ · checked just now                 ✕  │
╰──────────────────────────────────────────────╯

Install

Needs Claude Code 2.1.287 or later and the GitHub CLI logged in (gh auth login).

/plugin install pr-watch --marketplace ElirazKed/claude-code-pr-watch

Answer y to add the marketplace and press Enter for user scope. It's active at once, with no restart. Or in two steps:

/plugin marketplace add ElirazKed/claude-code-pr-watch
/plugin install pr-watch@claude-code-pr-watch

What it watches

• Automatically: PRs Claude opens (gh pr create, or a GitHub MCP create-pull-request call). Only open PRs are picked up; a merged or closed one never gets a card.
• When you ask: /pr-watch <url>, or paste a PR link in a prompt. These are watched in any state.
• When offered: if Claude touches any other PR (gh pr view/checks/merge, a fetched link, a GitHub MCP call, git push output), it asks you once whether to watch it. A PR Claude only read while researching doesn't land in your pane.

/pr-watch opens the pane, and /pr-watch stop <number|url|all> stops watching. Finished PRs stay until you dismiss them, d dismisses them all, and r refreshes.

Each card shows the state that matters most first: merge conflicts, then failing or running CI (naming the checks), then review, then whether GitHub will let it merge. A toast appears when the state changes, and the status line follows the focused PR.

How it polls

Every session on the machine shares one poller, so 30 sessions watching 30 PRs cost about one GitHub call every 20–60 seconds, not 30.

• Each session lists its PRs in ~/.cache/pr-watch/sessions/. The file's modified time is its heartbeat.
• When the shared results are due, one session takes a short lease and fetches every live session's PRs in one batched GraphQL query (40 per query). It writes them to ~/.cache/pr-watch/results.json, and the other sessions read that.
• It polls every 20s while CI is running somewhere and every 60s otherwise. It backs off when fewer than 300 calls of your rate limit remain.
• With several gh accounts logged in, a PR the active account can't see is retried with the others. The cache remembers which login sees which owner, never a token.

Develop

claude --plugin-dir .                # load it from this folder for one session
claude plugin validate .             # what it hooks and calls, and anything the engine would refuse
claude plugin test .                 # the *.test.ts suites

tsc -p . type-checks once Claude Code has loaded the mod, which writes .claude-plugin/types/.