GitHub - fanzeyi/jellycat: A Jellyfish inspired CLI tool for managing Jujutsu (jj) changesets with GitHub PRs

A jellyfish copycat

This is a Jellyfish inspired CLI tool for managing Jujutsu (jj) changesets with GitHub PRs. It aims to make sending stacks of changesets to GitHub easier.

Prerequisites

• Jujutsu (jj) with a colocated or native repo
• GitHub CLI (gh) authenticated via gh auth login
• Rust toolchain (to build from source)

Installation

Or if you want the latest,

cargo install --git https://github.com/fanzeyi/jellycat.git

Shell Completions

# Bash
jc completions bash > ~/.local/share/bash-completion/completions/jc

# Zsh
jc completions zsh > ~/.zfunc/_jc

# Fish
jc completions fish > ~/.config/fish/completions/jc.fish

Quick Start

# Initialize in a jj repo
jc init

# Create a commit and submit it as a PR
jj new -m "my feature"
jc submit

# Check PR status
jc status

# Clean up after PRs are merged
jc tidy

Demo

Integrations

Show PR Numbers in jj log

Jellycat stores changeset to PR mapping in jj config. This allows you to look up the PR number of your changeset directly in JJ's templating language.

However, dynamic config lookup is not supported in JJ until 0.40.0 (jj-vcs/jj#9148).

Add these template function to your JJ's config.toml

[template-aliases]
'pr_id(commit)' = 'config("jellycat.prs." ++ commit.change_id())'
'pr_url(commit)' = 'concat("https://github.com/", config("jellycat.upstream_repo").as_string(), "/pull/", pr_id(commit))'
'format_pr(commit)' = '''
if(pr_id(commit),
  label("jellycat_pr_link",
    hyperlink(pr_url(commit),
      "#" ++ pr_id(commit),
      concat("#", pr_id(commit), " ", pr_url(commit))
    )
  )
)
'''

You can customize the color of format_pr() with colors.jellycat_pr_link:

[colors]
jellycat_pr_link = "yellow"

I elected to overwrite the builtin format_short_commit_header(commit) to show PR link in my jj log default output. This is not the best practice but I do not want to rewrite the entire builtin_log_compact template yet:

'format_short_commit_header(commit)' = '''
separate(" ",
  format_short_change_id_with_change_offset(commit),
  format_short_signature(commit.author()),
  format_timestamp(commit_timestamp(commit)),
  commit.bookmarks(),
  commit.tags(),
  commit.working_copies(),
  format_short_commit_id(commit.commit_id()),
  format_commit_labels(commit),
  format_pr(commit),
  if(config("ui.show-cryptographic-signatures").as_boolean(),
    format_short_cryptographic_signature(commit.signature())
  ),
)
'''

Preview:

Commands

jc init [--force]

Initialize jellycat configuration for the current repository. Prompts for the upstream GitHub repo (owner/repo) and which git remote to push to.

Use --force to reconfigure an already-initialized repo.

jc submit [-r <REVSET>]

Push commits and create or update GitHub PRs.

• -r, --revset <REVSET> — Revset to submit (default: @, the current commit)
• -d, --draft — Create new PRs as draft (does not affect existing PRs)

This command:

1. Creates jj bookmarks for each commit
2. Pushes bookmarks to the configured remote
3. Creates new PRs or updates existing ones
4. Adds stack navigation links to PR bodies (for multi-PR stacks)

jc link [-r <REVSET>] <PR_NUMBER> [--force]

Manually associate a commit with an existing GitHub PR.

• -r, --revset <REVSET> — Revset to link (default: @)
• <PR_NUMBER> — The PR number to associate
• --force — Overwrite an existing PR association

jc unlink [-r <REVSET>] [PR_NUMBER]

Remove a PR association from a commit.

• -r, --revset <REVSET> — Revset to unlink (default: @)
• [PR_NUMBER] — Specific PR number to unlink (default: unlink all)

jc status

Show the status of all tracked PRs, including their GitHub state (open/merged/closed), comment counts, and associated commit info.

jc tidy

Clean up after merged, closed, or abandoned work:

• Removes config entries for changesets that have been abandoned in jj
• Abandons changesets linked to merged/closed PRs
• Removes all corresponding config entries

AI Assistant Integration

Teach your AI coding assistant (Claude Code, Cursor, etc.) how to use jc:

jc skills >> ~/.claude/CLAUDE.md       # Claude Code
jc skills >> .cursor/rules/jc.md       # Cursor

Configuration

Configuration is stored in jj's repo-local config under the jellycat.* namespace. Most keys are set automatically by init and submit.

Set config values with:

jj config set --repo jellycat.origin_repo "myuser/myrepo"