Jujutsu TUI #

A TUI for the Jujutsu version control system Our focus here is on:

• Performance: jj_tui should start fast and never slow you down, it should feel extremely snappy to browse your commits and files
• Intuitive: Keybindings should be easily memorizable and quick to commit to muscle memory without uneeded popups
• Interactivity: jj_tui completely re-implements jj's renderer so we can show realtime previews of the graph while you figure out how your rebase should look ( Use rebase preview to try it out!)

Press ? to show the help. (commands are different between graph and files view). Arrows or hjkl to navigate windows/items Space to select/deselect revisions (multi-select in graph view) Enter to widen the diff and scroll through it

Key features #

Normal jj operations #

• commiting
• rebasing
• git pushing and pulling
• Adding, moving and deleting bookmarks
• squashing and splitting commits
• space can be used to select multiple commits for copying, rebasing etc, starting a new commit on top of etc

Creating commits from the file view: #

• space can be used to select files to commit seperately or move to different commit
• Files and be sent to Next or Previous commits

filtering by revsets #

• filter by any revest you like

List of graph commands:

Installing #

linux: Grab the latest release. It's statically linked and should work on any linux machine. mac: Grab a prebuild. Let me know if you have any issues as I can't test on a mac.

To open a shell with jj_tui on nix: nix shell github:faldor20/jj_tui

Dependencies #

The jujutsu CLI (minimum version 0.30.0) I haven't tested on windows or Mac. I believe it won't work outside Unix so Windows users will currently have to use wsl.

Config file: #

You can make a config.yaml config file in the following directories to customize key inputs linux: $XDG_CONFIG_HOME/jj_tui/ macos: ~/Library/preferences/jj_tui/ See ./jj_tui/lib/key_map.ml for a spec for the keymap and ./jj_tui/lib/config.ml for the config The keymap config lets you fully customize all the commands and their sub menus as well as remap the arrow keys.

Eg:

key_map:
  remap:
   h: "left"
   j: "down"
   k: "up"
   l: "right"
  graph:
    #Simple mapping from key to command_id
    p: prev
    #Command sub menu
    s:
      title: "Squash"
      sub:
        # sub menu command
        s: "squash_into_parent"
# If the terminal is smaller than this width, the UI will change to a single pane view
single_pane_width_threshold: 110
# Sets the limit to how many commits are ever rendered in jj_tui. Usefull for not slowing down too much when viewing 'all()' revest.
max_commits: 100

For a full list of commands ids see jj_tui/bin/graph_commands.ml and jj_tui/bin/file_commands.ml

logs: #

linux: $XDG_STATE_HOME/jj_tui/ macos: ~/Library/logs/jj_tui/

Dev #

Can be built with nix nix build or open a nix shell with nix develop NOTE: if you are using the nix dev shell and would like to build with dune use dune build --pkg disabled to build using the deps provided by nix Can also be built directly with Dune package management via dune build.