jj-release 0.11.0

Semantic releases for Jujutsu VCS repositories
jj-release-0.11.0 is not a library.
Visit the last successful build: jj-release-0.5.0

jj-release

Automated semantic releases and changelogs for Jujutsu repositories.

Tools like release-plz and cargo-release are built around mutable Git branches. jj-release is built for jj: it walks history with revsets, moves bookmarks instead of branches, and starts a release from a commit message, so shipping is just another jj new.

Read the book →

Features

  • Semantic versioning from your commits. Bumps are computed from Conventional Commits, with cargo-semver-checks catching breaking API changes your commit messages missed.
  • Keep a Changelog output. Grouped, scoped, optionally emoji-headed sections prepended to CHANGELOG.md.
  • Forge releases and PRs on GitHub, GitLab, Forgejo/Codeberg, and Gitea.
  • Workspaces with unified or independent versioning, published in dependency order.
  • Version bumps everywhere. Manifests, cross-member dependencies, flake.nix, and any file you configure with regex replacements.
  • Distro packages. Optionally update your AUR package and submit a Fedora COPR build after each release.
  • Safe by default. Pre-flight checks run before anything changes, and nothing is pushed until the publish succeeds.

Rust is the primary target. npm and Go manifests are supported but less battle-tested.

Installation

cargo install jj-release

By default, only github and gitlab features are included.

# Forgejo/Codeberg only, no GitHub or GitLab
cargo install jj-release --no-default-features --features forgejo
Platform Command
Arch (AUR) paru -S jj-release
Arch (AUR, full) paru -S jj-release-full
Fedora sudo dnf copr enable sayless88/jj-release && sudo dnf install jj-release
Fedora (full) sudo dnf install jj-release-full
Nix nix run github:saylesss88/jj-release
From source cargo install --git https://github.com/saylesss88/jj-release
Cargo Binstall cargo binstall jj-release

Requires jj 0.43+ in a colocated repository (jj git init --colocate). Forge releases need gh or glab for GitHub and GitLab. See Installation for Cargo features, NixOS configuration, and optional tools.

For Forgejo/Gitea forge support and AUR/COPR publishing, install the full variant: paru -S jj-release-full or sudo dnf install jj-release-full.

Quick start

jj-release init       # detect forge, language and workspace; write release.toml
jj-release validate   # check that everything is ready

# When you're ready to ship:
jj new -m "Release: please"
jj-release --dry-run  # preview
jj-release            # release

jj-release runs locally or in CI. For GitHub Actions, see CI setup.

How it works

When jj-release finds a commit containing the trigger (Release: please by default) since the last version tag, it:

  1. Classifies commits since the last tag as major, minor, or patch, using the latest crates.io version as the baseline.
  2. Runs pre-flight checks, including cargo publish --dry-run.
  3. Writes the changelog and bumps versions.
  4. Creates a chore: release vX.Y.Z commit and tag.
  5. Publishes to crates.io.
  6. Moves the bookmark and pushes the commit and tag.
  7. Creates a forge release and updates distro packages, if configured.

If anything fails before the push, your remote is untouched. See Recovering from a failed release.

Prefer to review first? jj-release pr opens a pull request with the changelog preview instead of releasing.

Documentation

Repository layout

  • cli/: the jj-release binary
  • lib/: jj_release_core, the library behind it

Credits

Ideas and code adapted from release-plz (crates.io version baseline, semver checks), cargo-release, and git-cliff (changelogs).

License

Apache-2.0