Lucien Cartier-Tilet
1bab78cb20
Allows to set the revision message of multiple revisions by passing them as arguments. This only supports simple revisions, such as `@`, `@-`, `xs`, and so on. Comple revisions such as `@..@-` are not supported. Fixes: #5
jj-cz: Conventional Commits for Jujutsu
An interactive CLI tool that guides Jujutsu users through creating conventional commit messages.
Features
- Interactive prompts for type, scope, and description
- All 11 commit types with descriptions (feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert)
- Optional scope with validation
- 72-character first-line limit enforcement
- Preview before applying
- Clean cancellation with Ctrl+C
Usage
No fancy tricks, just run jj-cz.
jj-cz
The tool detects whether you're in a Jujutsu repository, guides you through the commit message, and applies it to your current change.
You can also set the revision message of a few revisions at once, or target a single revision other than the current one.
jj-cz @- xs develop
No explicit revision is simply the equivalent of jj-cz @, like
jj desc.
Requirements
- A Jujutsu repository
- An interactive terminal
You don’t need jj itself to be installed at all, though I’m not sure
what jj-cz alone would be good for without jj.
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success or clean cancellation |
| 1 | Error (invalid input, repository issues, jj failure) |
| 130 | Interrupted |
Installation
From crates.io
Simply run the following command:
cargo install jj-cz
Done! jj-cz is now available!
With Nix Flakes
Notice how there’s a flake.nix file? This means you can run the
project using this repository as one of your flakes inputs. In fact,
that’s how I install it in my own NixOS configuration! Add this
repository to your configuration:
{
inputs = {
nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
jj-cz = {
url = "git+https://labs.phundrak.com/phundrak/jj-cz";
inputs.nixpkgs.follows = "nixpkgs";
};
};
}
And tadah! you can now install
inputs.jj-cz.packages.${pkgs.stdenv.hostPlatform.system}.default
among your other packages. Take a look at my
jujutsu.nix
module if you need some inspiration.
From source
You can also install jj-cz with Cargo by building it from source.
Just make sure Rust is available on your machine (duh!).
cargo install --path .