idursun/jjui: Jujutsu UI (jjui) is a Text User Interface (TUI) designed for interacting with the Jujutsu version control system.

Posted on by


Build & Test

jjui is a terminal user interface for working with Jujutsu version control system. I have built it according to my own needs and will keep adding new features as I need them. I am open to feature requests and contributions.

Currently, you can:

Change revset with auto-complete

You can change revset while enjoying auto-complete and signature help while typing.

GIF

You can rebase a revision or a branch onto another revision in the revision tree.

GIF

See Rebase for detailed information.

You can squash revisions into one revision, by pressing S. The following revision will be automatically selected. However, you can change the selection using j and k.

GIF

Pressing l (as in going right into the details of a revision) will open the details view of the revision you selected.

In this mode, you can:

  • Split selected files using s
  • Restore selected files using r
  • View diffs of the highlighted by pressing d

GIF

For detailed information, see Details wiki page.

You can move bookmarks to the revision you selected.

GIF

You can switch to op log view by pressing o. Pressing r restores the selected operation. For more information, see Op log wiki page.

GIF

You can open the preview window by pressing p. If the selected item is a revision, then the output of jj show command is displayed. Similarly, jj diff output is displayed for selected files, and jj op show output is displayed for selected operations.

While the preview window is showing, you can press; ctrl+n to scroll one line down, ctrl+p to scroll one line up, ctrl+d to scroll half a page down, ctrl+u to scroll half a page up.

Additionally, you can press d to show the contents of preview in diff view.

For detailed information, see Preview wiki page.

GIF

Additionally,

  • View the diff of a revision by pressing d.
  • Edit the description of a revision by pressing D
  • Create a new revision by pressing n
  • Split a revision by pressing s.
  • Abandon a revision by pressing a.
  • Absorb a revision by pressing A.
  • Edit a revision by pressing e
  • Git push/fetch by pressing g
  • Undo the last change by pressing u
  • Show evolog of a revision by pressing v

See configuration section in the wiki.

The latest release of jjui is available on Homebrew core:

The built jjui binary from latest release is available on the AUR:

paru -S jjui-bin
# OR
yay -S jjui-bin

You can install jjui using nix from the unstable channel.

If you need to use a particular branch/revision that
has not yet landed into nixpkgs. You can install it via
our provided flake.

nix profile install github:idursun/jjui/main

To install the latest released (or pre-released) version:

go install github.com/idursun/jjui/cmd/jjui@latest

To install the latest commit from main:

go install github.com/idursun/jjui/cmd/jjui@HEAD

To install the latest commit from main bypassing the local cache:

GOPROXY=direct go install github.com/idursun/jjui/cmd/jjui@HEAD

You can build jjui from source.

git clone https://github.com/idursun/jjui.git
cd jjui
go install ./...

You can download pre-built binaries from the releases page.

Minimum supported jj version is v0.21+.

Feel free to submit a pull request.



Source link