Home

Awesome

lazyjj

TUI for Jujutsu/jj. Built in Rust with Ratatui. Interacts with jj CLI.

https://github.com/Cretezy/lazyjj/assets/2672503/b5e6b4f1-ebdb-448f-af9e-361e86f0c148

Features

Setup

Make sure you have jj installed first.

To build and install a pre-release version: cargo install --git https://github.com/Cretezy/lazyjj.git --locked

Configuration

You can optionally configure the following options through your jj config:

Example: jj config set --user lazyjj.diff-format "color-words" (for storing in user config file, repo config is also supported)

Usage

To start lazyjj for the repository in the current directory: lazyjj

To use a different repository: lazyjj --path ~/path/to/repo

To start with a different default revset: lazyjj -r '::@'

Key mappings

See all key mappings for the current tab with h or ?.

Basic navigation

Log tab

Files tab

Bookmarks tab

Command log tab

Development

Setup

  1. Install Rust and
  2. Clone repository
  3. Run with cargo run
  4. Build with cargo build --release (output in target/release)
  5. You can point it to another jj repo with --path: cargo run -- --path ~/other-repo

Logging/Tracing

lazyjj has 2 debugging tools:

  1. Logging: Enabled by setting LAZYJJ_LOG=1 when running. Produces a lazyjj.log log file
  2. Tracing: Enabled by setting LAZYJJ_TRACE=1 when running. Produces trace-*.json Chrome trace file, for chrome://tracing or ui.perfetto.dev