jabr — stacked pull requests

Jabr

jabr (Arabic, جَبْر — "the reunion of broken parts"; the root of al-jabr → algebra). Reunite a feature's broken-down pieces into one clean, reviewable whole.

A Claude-native stacked pull request workflow — implemented entirely with plain git and the GitHub gh CLI. No external service, no account, no daemon. It ships as a Claude Code agent skill plus a self-contained TypeScript engine you can also drive by hand.

Instead of one giant pull request, you break a feature into a stack of small, dependent PRs — each one reviewable on its own, each branched off the one below it. jabr tracks the parent/child graph, restacks (rebases) descendants when a lower branch changes, and submits the whole stack to GitHub with correct base branches and a navigation comment.

Idea visualized

A 30-second walkthrough of the whole flow — decompose → stack → restack → submit → sync — animated from the jabr logo. The preview below plays silently; click it to watch the full video with audio.

Why stack?

• Smaller diffs → faster, better reviews. A 1,500-line PR gets rubber-stamped; five 300-line PRs get read.
• Unblock yourself. Keep building on top of work that's still in review.
• Logical history. Each PR is one coherent change (schema → backend → API → UI → tests).

What makes it Claude-native

Claude is the operator. It plans the decomposition, writes the code on each branch, and authors the PR descriptions — while this engine handles the deterministic git/gh mechanics (parent tracking, rebase --onto, force-push ordering, PR base wiring) reliably.

Requirements

• Bun — the engine is a TypeScript program run directly with Bun (no build step, zero runtime dependencies)
• A git repository
• gh authenticated (gh auth login) — only needed for submit/sync; all local stack operations work without it

Install

jabr is distributed as a Claude Code plugin. Add this repo as a marketplace and install it — Claude Code then loads the skill automatically (and it also auto-activates from its description):

/plugin marketplace add ahmadatallah/jabr
/plugin install jabr@ahmadatallah

The marketplace is named ahmadatallah, so the plugin installs as jabr@ahmadatallah. Pin a tagged version if you prefer: /plugin marketplace add ahmadatallah/[email protected].

Bun and (for submit/sync) an authenticated gh are still required on your machine — the plugin can't install them for you.

To run the engine by hand for development, clone the repo and alias the script directly:

git clone https://github.com/ahmadatallah/jabr.git
alias jabr='bun /path/to/jabr/scripts/jabr.ts'

Quick start

jabr init                      # detect/record the trunk (main)
jabr create api-schema -a -m "Add user schema + migration"
#   ...edit code...
jabr create api-endpoints -a -m "Add /users endpoints on the schema"
#   ...edit code...
jabr create api-ui -a -m "Wire the users list UI to the endpoints"

jabr log                       # see the stack
jabr submit --stack            # push + open a PR per branch, bases wired, nav comment added

Address review feedback on a lower branch, then realign everything above it:

jabr down                      # move to the parent branch
#   ...fix code...
jabr modify -a                 # amend + auto-restack all descendants
jabr submit --stack            # update all PRs

After a branch merges:

jabr sync                      # ff trunk, drop merged commits, restack the rest, prompt-delete

Command reference