Wow, a major release after a very long time. As promised, v0.10 is ready, and it comes with breaking changes.
First, thank you to everybody who contributed code, bug reports, ideas, and testing for this release. In particular, thanks to @baggiiiie for various features and fixes, @nickchomey for contributions and continuous feedback, and @vic for updating the documentation website. Thanks as well to everyone else for various code contributions, reporting issues, and verifying fixes.
We changed a lot in v0.10, but the biggest shift is that we finally got rid of some legacy configuration and moved to a unified actions + bindings model. Old concepts like [custom_commands] and [leader] are now replaced by a more consistent system built around actions, bindings, and first-class support for leader-style key sequences.
This release also introduces config.lua, which makes it much easier to customise and extend jjui with real scripting instead of only static configuration. Between config.toml, config.lua, Lua actions, and bindings, much more of the UI can now be customised in one consistent way.
The documentation has been updated with migration notes and examples such as the Lua Cookbook.
From my testing it looks ready, but I am sure more rough edges will show up once more people start using it, so please keep reporting issues as you find them.
⚠️ Breaking Changes
v0.10 replaces the legacy keybinding and customisation model with the new actions + bindings system.
[keys]configuration is no longer used.[custom_commands]is replaced by[[actions]]and[[bindings]].[leader]sequences are replaced by sequence bindings viaseq.
If you have an existing configuration, plan to migrate it rather than expecting a drop-in upgrade from v0.9.x.
✨Highlights
- Unified actions + bindings system. Keyboard input now flows through a single dispatch pipeline, default bindings are declared in TOML, actions are discoverable, and custom behaviour can be defined in both TOML and Lua.
- Much stronger scripting support. Lua
setupnow receives the full config plus runtime context, generated intent-backed actions replace handwritten drift-prone bridges, and new helpers likewait_close()andwait_refresh()make multi-step scripts more predictable. - Upgraded TUI foundations. Moving from Bubble Tea v1 to v2 brings better terminal support, a new rendering engine for better performance, and better input handling, including support for bindings like
ctrl+spaceand dedicatedshift+...style keys. - Improved diff and selection workflows. The
diffview now supports word wrap,revisionsanddetailssupport modifier-based mouse selection, and severaldetailsandevologinteractions are more consistent.
🚀 New and Improved
Command History
- Added command history, available with
shift+w, to review dismissed command runs together with their output. - Moved running command information out of the status area and into dedicated
flashmessages, so the command and its output are now shown together in one place.
Help and Status
- Reintroduced a dedicated Help view for full keybinding discovery, with filtering and scrolling, alongside the existing inline help.
- Changed status/help binding presentation to column-major order so related bindings are easier to scan.
Lua and Configuration
- Shipped the unified actions + bindings architecture introduced in
v0.10. - Exposed the full config object to Lua
setup, including runtime context such as repository path viaconfig.repo, and terminal state viaconfig.terminal.dark_mode,config.terminal.fg, andconfig.terminal.bg. - Standardised closeable action naming around
open_*and aligned apply/close semantics for more predictable scripted workflows.
Oplog
- Added quick search to
oplogand shared the search behavior with revision search.
Evolog
- Changed
evologpreview defaults to show interdiff output, matchingjj evolog -pmore closely.
Abandon
- Added
sinabandonmode to target descendants of the selected revision(s).
Revset
- Kept
revsetediting open when the expression is invalid, improving iteration while editing. - Improved
revsetediting so function completion inserts(when appropriate, while the function list display is cleaner and less noisy.
Diff
- Added word wrap in the
diffview, with explicit wrapped and unwrapped modes plus soft-wrap-aware scrolling. - Added
gandGin thediffview to jump to the top and bottom.
Details and Revisions
- Added
Ctrl+clicksingle-item toggle andAlt+clickrange selection inrevisionsanddetails. - Added a
revisions.details.select_fileaction for finer control indetailsworkflows.
🛠️ Fixes
- Fixed rendering issues with double-width characters.
- Simplified divergent revision handling by using
change_id/offsetdirectly from thejj logprefix template. - Fixed
git push --allbehaviour for deleted bookmarks and corrected related command descriptions.
⚙️ Internal Updates
- Upgraded to Bubble Tea v2.
- Replaced remaining
cellbufusage withultraviolet. - Hardcoded model-level key handling has been removed in favor of dispatcher-driven intents.
- Continued internal cleanup around rendering, overlays, display context, and generated action plumbing to support the new architecture.
What's Changed
- Unified Actions + Bindings system by @idursun in #533
- feat(oplog): add QuickSearch to oplog, share logic with revision search by @baggiiiie in #521
- fix: add missing keys in bindings by @baggiiiie in #538
- feat(evolog): change default evolog command to show interdiff by @academician in #539
- fix: add back
escto clear checked revisions by @baggiiiie in #541 - remove gh-pages workflow from main branch. by @vic in #542
- docs: fix readme links by @baggiiiie in #549
- Update CONTRIBUTING.md for documentation by @vic in #547
- feat(lua): add "filter" and "ordered" option to
chooselua api by @baggiiiie in #548 - feat(abandon): use
sfor selecting descendants by @idursun in #544 - feat: add change_offset in jj log prefix template for divergent revisions by @baggiiiie in #550
- fix: make bookmark input visible when user has custom template-aliases by @baggiiiie in #551
- fix(evolog): keep restore mode navigation on revisions and esc close by @baggiiiie in #554
- Expose full config to Lua setup and add runtime context (repo + terminal) by @idursun in #553
- feat(flash): command history by @idursun in #556
- Update to bubbletea v2 by @idursun in #558
- Ctrl+click and Alt+click for single and range selection by @idursun in #563
- feat: add
(to functions when autocompleted by @nickchomey in #564 - feat(status): change display to column major order by @baggiiiie in #569
- fix: remove parentheses from functions list, but add when autocomplete by @nickchomey in #567
- fix(git): prevent panic when opening git menu with no selected revision by @baggiiiie in #571
- Refactor/Lua bridge by @idursun in #572
- fix(ui): guard against nil commit in OpenBookmarks intent by @baggiiiie in #573
- feat(diff): word wrap by @idursun in #575
- Add pgup/pgdown keybindings to evolog and details by @academician in #576
- feat(lua): make default actions overridable and expose jjui.builtin.* by @idursun in #577
- feat(help): add "help view" bound to
f1by @idursun in #578
New Contributors
- @academician made their first contribution in #539
Full Changelog: v0.9.12...v0.10.0