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

Introduction

jj-gh brings GitHub pull request workflows into Jujutsu (jj). It works with the jj Git backend, so you can create, inspect, and reconcile PRs while staying in your terminal and in the jj graph.

Highlights

  • Create PRs from arbitrary revisions. jj pr create <rev> opens your editor on a Markdown body seeded from your configured jj template or repository PR template. YAML frontmatter controls title, base, labels, reviewers, draft state, and auto-merge. The nearest ancestor bookmark can supply the base branch. See Configuration and Templates.

  • Native GitHub stacked PRs. New PRs can be linked into GitHub’s stacked PRs feature automatically. jj-gh links new PRs on top of an existing stack and reshapes stacks as your local graph changes. See Stacked PRs.

  • Stack reconciliation. jj pr stack compares your local PRs with the jj graph and proposes a plan to create, reshape, or dissolve GitHub stacks so GitHub matches your local chains. It prints the plan and asks for confirmation before making changes; --dry-run prints it and stops. See Reconciling stacks.

  • PR metadata in the log. jj pr log injects PR number, URL, CI status, and merge status into jj log-style output.

  • Fetch PR bookmarks across forks. jj pr fetch 1234 creates a local bookmark for the PR head, including PRs from forks: jj pr fetch 1234 && jj new pr-1234/.... See Fetch.

  • Auto-merge and CI reruns. Enable auto-merge from a revision ID (jj pr auto-merge zqxy) without looking up the PR number, and re-run failed CI with jj pr rerun. See Auto-merge and rerun.

Relationship to megamerge workflows

jj-gh works well with the jj megamerge workflow, but it does not create or manage the megamerge itself. You shape the local jj graph (for example with jj rebase); jj-gh creates, edits, and reconciles the PRs that represent that shape. See Megamerge workflow.

Where to go next