Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

jjpr

jjpr manages stacked pull requests for Jujutsu repositories. It pushes bookmarks, creates and updates PRs/MRs, merges them, and syncs the stack on GitHub, GitLab, and Forgejo.

See Installation to get started.

Stacked PRs are chains of small pull requests that branch off of each other. They are better structured and easier to review than one large PR, and they let the developer focus on one feature by working ahead of the reviewer.

Commands

jjpr submit and jjpr watch are what most users want. submit pushes up the current stack of bookmarks as a stack of PRs to the forge. watch runs in a loop, creating PRs for new bookmarks, promoting drafts when CI passes, and merging from the bottom up once each PR is approved.

Other lower-level commands are there for manual control and debugging.

  • merge: merge a stack from the bottom up, one-shot.
  • status: show the current stack and PR state.
  • auth: test or set up forge authentication.
  • config: manage config files.

Reference