sincecutoff.com
← all changes

jj diff editors support file-by-file invocation

Introduced 2026-06-04 · score 0.94

HOW TO USE IT

When editing changes with a per-file diff editor, set `edit-invocation-mode` to `"file-by-file"` under that editor’s `[merge-tools.<tool>]` config; jj then launches the editor once per changed file. [jj v0.42.0 config docs](https://github.com/jj-vcs/jj/blob/v0.42.0/docs/config.md)

[ui] diff-editor = "<tool>" [merge-tools.<tool>] edit-invocation-mode = "file-by-file"

WHY THIS HELPS

Edit changed files separately when using a per-file diff editor with `jj diffedit` or `jj split`.

REQUIREMENTS AND LIMITATIONS

  • Version: v0.42.0
  • `ui.diff-editor`: Selects the default diff editor; the docs say it defaults to the built-in editor if unset.
  • `merge-tools.<tool>.edit-invocation-mode` (required): Sets the diff editor invocation mode; use `"file-by-file"` to invoke it once per changed file. No mutually exclusive sub-keys are documented.
  • `merge-tools.<tool>.edit-args`: Sets arguments for the selected diff editor; defaults to `["$left", "$right"]` when unset. An empty list makes jj refuse to use the tool for diff editing.
  • Prerequisite: Use an installed diff editor that supports per-file invocation; the release note names `vimdiff` as an example.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card