config.toml

jjui reads configuration from a TOML file at startup.

Default locations:

• Linux / macOS: ~/.config/jjui/config.toml
• Windows: %AppData%/jjui/config.toml
• Custom: $JJUI_CONFIG_DIR/config.toml

Open the file directly in your editor with:

jjui --config

---

Revisions

Override the default log template or revset:

[revisions]
template = "builtin_log_compact"
revset = ""
log_batching = true
log_batch_size = 50

• log_batching: load revisions incrementally in batches (default: true)
• log_batch_size: number of revisions per batch when batching is enabled (default: 50)

Preview

[preview]
position = "auto"          # auto | right | bottom
show_at_start = false
width_percentage = 50.0
width_increment_percentage = 5.0

Op Log

[oplog]
limit = 200

SSH

Disable jjui’s SSH askpass helper if you manage SSH credentials yourself:

[ssh]
hijack_askpass = false

Exec suggestions

Controls autocomplete suggestions in the : and $ command prompts:

[suggest.exec]
mode = "fuzzy"   # off | regex | fuzzy

Auto-refresh

[ui]
auto_refresh_interval = 0

Seconds between automatic revision list refreshes. Default is 0 (disabled). Override at startup with --period.

Flash messages

[ui]
flash_message_display_seconds = 4

How long success flash messages stay visible in seconds. Default is 4. Set to 0 to keep them until manually dismissed with esc.

Colors and themes

Quick inline overrides go in [ui.colors]:

[ui.colors]
"selected" = { bg = "#303446" }

For a full theme file, see Themes.

Bindings profile

Load an alternative bindings file as the base instead of the built-in defaults:

bindings_profile = "vim_bindings.toml"

Your own [[bindings]] entries are applied on top of the profile. Use :builtin to explicitly reset to embedded defaults.

For defining actions and bindings, see Actions and Bindings.