jjdiff

A TUI that can be used as a diff editor in the jujutsu vcs.

jjdiff will show all changes and allow you to navigate through them and (partially) select them to be included.

jjdiff makes it easy to navigate the diff by having a 2 dimensional cursor that can 'grow' and 'shrink'.

This cursor can operate on 3 levels:

• Change: select an entire change
• Hunk: select a group of edited lines in a file
• Line: select a single edited line in a file

Keybindings

Usage

jjdiff is available on pypi. You can use any way you are comfortable installing python applications.

You can then use it by adding the following settings to ~/.config/jj/config.toml:

[ui]
diff-editor = "jjdiff"
diff-instructions = false  # not required but recommended
diff-formatter = ["jjdiff", "--print", "$left", "$right"]  # to also format diffs using jjdiff

Configuration

jjdiff can be configured in ~/.config/jjdiff/config.toml or at $XDG_CONFIG_HOME/jjdiff/config.toml if set. The following configuration options are supported:

diff.deprioritize

This contains a list of gitignore style globs that can be used to deprioritize certain files in diffs. Deprioritizing has the following effects:

• Deprioritized files are always at the end of the diff.
• In jjdiff --print the changes in deprioritized files are not shown.

editor.default_open

Controls if changes are by default open or closed. Deprioritized files will remain closed by default even if this setting is set to true. Default is false.

editor.auto_open

When navigating away from an opened change, automatically closes it and opens the next one. Default is false.

format.tab_width

Controls as how many spaces a tab is formatted in the diff. Default is 4.

keybindings

A dictionary mapping command names to lists of keys that should trigger the command. The default value for each command matches the keybindings table shown earlier in this document.