Chrome extension for GitHub pull requests
Stop merging pull requests out of order.
MergeChain adds merge dependencies to GitHub PRs. Say a PR is blocked by another, and its merge button stays disabled until the prerequisite lands. Works great with humans and AI coding agents (Claude, Cursor, Copilot, Grok…). Get it from the Chrome Web Store or download the ZIP directly.
What it does
Order enforced where it matters: the merge button.
Blocks the merge
While any dependency (direct or indirect) is unmerged, the merge button turns red and reads “Waiting on deps.” The tooltip names the blocker.
Cross-repo & transitive
Chain A → B → C, fan in from many PRs, share a common prerequisite. Dependencies can point across repositories, and cycles are detected.
No backend
Dependencies live inside the PR body, readable with or without the extension. Your token stays in your browser and talks only to api.github.com.
How it works
Three steps. No separate accounts, no servers.
Declare the dependency
On any PR, add another as Blocked by, in the same repo (#128) or another (acme/db#128).
It’s saved in the PR
Stored as a hidden note in the PR description, so the relationship travels with the PR and survives without the extension.
Merge waits its turn
The button stays blocked until every prerequisite is merged. See the chain as a list or a graph.
Install
Get it running in a minute.
- Add to Chrome (recommended — direct from the Chrome Web Store)
- Download ZIP from GitHub Releases → extract → Load unpacked (Developer mode). Same build attached to every release. Great for sideloading or air-gapped use.
- Or build from source (see README on GitHub).
- Open the extension’s Options and sign in with GitHub (device flow or fine-grained PAT with PR read/write).
For AI Agents & Coding Assistants
Easy integration for Claude, Cursor, Copilot, Grok & more
Let your agent automatically declare merge dependencies when creating stacked PRs. The skill writes the exact same marker as the browser extension so humans see it too. Works with Claude, Cursor, Copilot, Grok and more. Copy the prompt below or grab the full skill from GitHub.
You have the MergeChain PR dependency skill.
After you create a PR (especially stacked ones), run:
node skills/mergechain-deps/mc-deps.mjs auto <pr-number>
Other commands:
- node skills/mergechain-deps/mc-deps.mjs show <pr>
- node skills/mergechain-deps/mc-deps.mjs add <pr> <dep>
- node skills/mergechain-deps/mc-deps.mjs rm <pr> <dep>
Always report the exact output. Full guide: skills/mergechain-deps/SKILL.md
- Copy
skills/mergechain-deps/into your project - Place
SKILL.mdat.claude/skills/mergechain-deps/SKILL.md - Or paste the Universal prompt above
- Use
skills/mergechain-deps/adapters/cursor/ - Add to
.cursor/rules/or project rules - Paste the Universal prompt
.github/prompts/mergechain-deps.prompt.mdis included- Copilot picks it up automatically
- Or paste the Universal prompt in custom instructions
- Paste the Universal prompt into context or rules
- Use the matching adapter in
skills/mergechain-deps/adapters/ - Ensure
gh+ Node are available to the agent
Full details + adapters for Claude, Cursor, Copilot, Grok and more: skills/mergechain-deps on GitHub
Works great with: Claude Code • Cursor • GitHub Copilot • Grok • Windsurf • Kiro and any agent that can run shell commands.
auto)