jj - Jujutsu CLI
This plugin provides autocompletion for jj.
To use it, add jj to the plugins array of your zshrc file:
plugins=(... jj)
Aliases
| Alias | Command |
|---|---|
| jjc | jj commit |
| jjcmsg | jj commit --message |
| jjd | jj diff |
| jjdmsg | jj desc --message |
| jjds | jj desc |
| jje | jj edit |
| jjgcl | jj git clone |
| jjgf | jj git fetch |
| jjgfa | jj git fetch --all-remotes |
| jjgp | jj git push |
| jjl | jj log |
| jjla | jj log -r "all()" |
| jjn | jj new |
| jjrb | jj rebase |
| jjrs | jj restore |
| jjrt | cd "$(jj root || echo .)" |
| jjsp | jj split |
| jjsq | jj squash |
Prompt usage
Because jj has a very powerful template syntax, this
plugin only exposes a convenience function jj_prompt_template to read information from the current change.
It is basically the same as jj log --no-graph -r @ -T $1:
_my_theme_jj_info() {
jj_prompt_template 'self.change_id().shortest(3)'
}
PROMPT='$(_my_theme_jj_info) $'
jj_prompt_template escapes % signs in the output. Use jj_prompt_template_raw if you don't want that
(e.g. to colorize the output).
However, because jj can be used inside a Git repository, some themes might clash with it. Generally, you can
fix it with a wrapper function that tries jj first and then falls back to git if it didn't work:
_my_theme_vcs_info() {
jj_prompt_template 'self.change_id().shortest(3)' \
|| git_prompt_info
}
PROMPT='$(_my_theme_vcs_info) $'
You can find an example here.
Performance
Sometimes jj can be slower than git.
If you feel slowdowns, consider using the following:
zstyle :omz:plugins:jj ignore-working-copy yes
This will add --ignore-working-copy to all jj commands executed by your prompt. The downside here is that
your prompt might be out-of-sync until the next time jj gets a chance to not ignore the working copy (i.e.
you manually run a jj command).
If you prefer to keep your prompt always up-to-date but still don't want to feel the slowdown, you can make your prompt asynchronous. This plugin doesn't do this automatically so you'd have to hack your theme a bit for that.
See Also
Contributors
- nasso - Plugin Author