jj-ai
| Crates.io | jj-ai |
| lib.rs | jj-ai |
| version | 0.1.0 |
| created_at | 2026-01-11 06:19:48.784879+00 |
| updated_at | 2026-01-11 06:19:48.784879+00 |
| description | AI-powered tools for jj version control |
| homepage | |
| repository | |
| max_upload_size | |
| id | 2035272 |
| size | 116,992 |
Anibal Angulo (ajac-zero)
documentation
README
jj-ai
A plugin for JJ that adds AI-powered utility commands.
Commands:
-
describe: Automatically generate a commit message following a standard (generic,conventional,gitmoji)
Installation
Install the binary:
cargo install jj-ai
Add plugin to jj:
jj config set --user aliases.ai '["util", "exec", "--", "jj-ai"]'
Configuration
Set the following environment variables:
| Variable | Required | Default | Description |
|---|---|---|---|
OPENROUTER_API_KEY |
Yes | — | Your OpenRouter API key |
JJAI_MODEL |
No | openai/gpt-4o-mini |
OpenRouter model to use |
Usage
Generate description for current commit:
jj ai describe
Generate description for a specific revision(s):
# jj ai describe -r <revset>
jj ai describe -r @ # <- Generate commit message for the current commit (default)
jj ai describe -r .. # <- Generate commit messages for all commits
By default, jj ai describe will skip generating messages for commits that already have one.
You can overwrite this behaviour with the --overwrite flag.
jj ai describe --overwrite
Preview generated commit without applying:
jj ai describe --dry-run