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 configuredjjtemplate 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-ghlinks new PRs on top of an existing stack and reshapes stacks as your local graph changes. See Stacked PRs. -
Stack reconciliation.
jj pr stackcompares your local PRs with thejjgraph 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-runprints it and stops. See Reconciling stacks. -
PR metadata in the log.
jj pr loginjects PR number, URL, CI status, and merge status intojj log-style output. -
Fetch PR bookmarks across forks.
jj pr fetch 1234creates 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 withjj 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
- Installation — install
jj-ghand set up thejj pralias. - Getting started — the minimal first-use flow.
- Authentication — provide a GitHub token.
- Everyday workflows — log, edit, fetch, auto-merge, and rerun.
- CLI reference — the full generated command reference.