What problem does it solve?
You need to merge a chain of stacked Pull Requests (base → top) without breaking later layers, while ensuring each upper layer is rebased onto the updated main branch and that the umbrella issue closes.
Core Features & Use Cases
- Order-safe stacked PR merging: merges layer 1 first, then processes layers 2..N in sequence to preserve correct bases.
- Explicit base migration before rebasing: updates each upper PR’s GitHub base to
main before performing a local rebase and force-push.
- Operational guardrails and validation: checks CI status, approval presence, mergeability, and umbrella issue closure; stops when conflicts arise and delegates resolution to the rebase kata.
- Two execution paths: supports a vanilla
gh + git workflow and a git-spice variant for syncing/rebasing after merges.
Quick Start
Run the stacked merge procedure for a stack of N PR layers using gh pr merge in order, and for each upper layer first change the PR base to main, then rebase onto origin/main, force-push with lease, and merge via CLI.