GitHub Integration

LazyJJ integrates with GitHub CLI (gh) to create and manage stacked pull requests.

Prerequisites

Install GitHub CLI and authenticate:

# Install gh (see https://cli.github.com/)
brew install gh  # macOS
# or your package manager

# Authenticate
gh auth login

PR Commands

Command	Shortcut	Purpose
pr-view	prv	View current PR
pr-open	pro	Open current PR in browser
pr-stack	-	List bookmarks in stack
pr-stack-create	sprs	Create/update stacked PRs
pr-stack-summary	prs	Generate PR stack summary
pr-stack-update	uprs	Update PR comments with stack info
pr-stack-md	prmd	Formatted PR stack with CI/review status

Basic Workflow

# View the PR for your current branch
jj pr-view

# Open it in the browser
jj pr-open

Stacked PRs

LazyJJ makes stacked PRs easy. First, create bookmarks for each commit:

# Create your stack
jj stack-start
jj describe -m "Add database schema"
jj create db-schema
jj new

jj describe -m "Add user model"
jj create user-model
jj new

jj describe -m "Add user API"
jj create user-api

Then create/update all PRs at once:

# Create stacked PRs for all bookmarks
jj pr-stack-create

This will:

1. Push each bookmark to the remote
2. Create a PR for each bookmark
3. Set the base branch correctly for stacking

PR Stack Summary

Generate a summary of your PR stack:

# Markdown format
jj pr-stack-summary

# Output:
# ## PR Stack
#
# - [user-api](https://github.com/...): Add user API
# - [user-model](https://github.com/...): Add user model
# - [db-schema](https://github.com/...): Add database schema

Update PR descriptions with the stack summary:

jj pr-stack-update

Understanding Bookmarks and Branches

One of the most common sources of confusion:

• JJ calls them: Bookmarks
• GitHub calls them: Branches
• They’re the same thing

Why Bookmarks Don’t Auto-Follow

Unlike Git branches, JJ bookmarks stay where you set them. Update manually with jj bookmark set my-feature -r @. See Common Mistakes for details.

The ghbranch Revset

LazyJJ provides a revset to find the current bookmark for GitHub:

# See which bookmark will be used
jj log -r ghbranch

Utility Commands

Command	Shortcut	Purpose
github-repo	repo	Get GitHub repo from origin
gh	-	Run any gh command in repo context

# Get the repo name
jj github-repo  # -> owner/repo

# Run any gh command
jj gh pr list
jj gh issue create

Tips

Finding the Right Bookmark

LazyJJ uses ghbranch to find the bookmark for the current position:

# See which bookmark will be used
jj log -r ghbranch

Rebasing After Merge

When a PR in your stack is merged:

# Sync with trunk (rebases your stack)
jj stack-sync

# Push updated stack
jj stack-submit

Manual PR Base

If you need to set a PR’s base manually:

gh pr edit my-branch --base other-branch

My Bookmark Didn’t Update

See Common Mistakes.