tij 0.6.1

Text-mode interface for Jujutsu - a TUI for jj version control
Documentation

Tij

Text-mode Interface for Jujutsu - A TUI for the Jujutsu version control system, inspired by tig.

Rust Crates.io

Why Tij?

Jujutsu (jj) makes Git's painful operations easy and safe. Tij brings that power to a visual interface:

Git's Pain jj's Solution Tij's UI
git stash management Always-committed working copy One-key context switching
git rebase -i complexity jj edit + auto-rebase Visual history editing
git reflog recovery jj undo / jj op log Operation history view
Commit splitting jj split Integrated diff editor
Conflicts block work Keep conflicts, continue working Visual conflict status

Installation

# Homebrew (macOS/Linux)
brew tap nakamura-shuta/tij && brew install tij

# From crates.io
cargo install tij

# From source
git clone https://github.com/nakamura-shuta/tij.git
cd tij && cargo install --path .

Requirements: Jujutsu >= 0.41.0 in PATH (Homebrew installs it automatically)

Quick Start

cd /path/to/jj-repo
tij

Press ? for help, q to quit.

Features

Area Features
Views Log (with split-pane preview) / Diff / Status (s) / Help / Operation History (o) / Blame (with Log jump) / Bookmark (b) / Tag (t) / Workspace (w, Enter jump / n add / d forget / r rename, <name>@ markers in Log) / Evolog (L, evolution history) / Command History (H, shows executed jj commands with OK/NG status)
History Editing Describe (d quick edit / Ctrl+E external editor) / Edit (e) / New change (c) / New from selected (C) / Squash (S) / Abandon (A) / Split (x) / Rebase (R: revision/source/branch/insert-after/insert-before, with --skip-emptied toggle and revset input for multi-revision rebase) / Absorb (B) / Resolve conflicts (X). Low-frequency ops via command palette (:): interdiff / compare / duplicate / revert / simplify-parents / parallelize / metaedit / arrange / bisect / fix
Conflict Resolution Resolve List View / :ours / :theirs / External merge tool / Conflict jump
Recovery Undo u (shows undone operation detail) / Redo Ctrl+R — available in all mutating views (Log, Status, Bookmark, Tag, Workspace, Operation, Resolve) / Operation Restore / Restore file / Restore all
Bookmarks b opens Bookmark View; in-view ops: Enter jump / n create / d delete / r rename / t track / T untrack / f forget / m move to @ (with backward detection). Create target defaults to Log selection (else @).
Tags Tag View (t): Enter jump / n create / d delete. Jump supports revset expansion.
Git Integration Fetch (multi-remote selection, branch-specific fetch, tracked-only fetch) / Push (with dry-run preview, force push warnings, protected bookmark detection, multi-remote selection, push-by-change, push-by-revision, bulk options: --all/--tracked/--deleted, auto-retry for private commits and empty descriptions)
Navigation Next/Prev (]/[ to move @ through history) / Reversed log order (V)
Diff Display mode cycle (m: color-words → stat → git) / Copy to clipboard (y full / Y diff-only) / Export to .patch file (w, git unified format). Compare, interdiff, and bisect are reachable via command palette (:) in Log View.
Usability Command palette (:, fuzzy-search low-frequency commands) / Current-view help (? shows only the current view's keys, a toggles all views) / Revset filtering (with count + truncation indicator) / Text search / Adaptive status bar / Dynamic context-aware hints / --limit 200 for all queries / Startup jj version check (>= 0.41)

Revset Examples

Press r to filter commits:

all()                    # Show all commits
@-..@                    # Recent commits
author(email)            # By author
ancestors(main)          # Branch history

See jj revset docs for more.

Default Display

Tij uses jj's default revset (recent/relevant commits). To see all:

  1. Press r, type all(), Enter
  2. Or set in ~/.jjconfig.toml: 
    [revsets]
log = "all()"

Development

cargo test                    # All tests (unit + integration)
cargo test --lib              # Unit tests only
cargo test --tests            # Integration tests only
cargo insta test              # Snapshot tests

Test categories: Unit (741), Integration (86), Snapshot (20), Property-based (15)

Acknowledgments

License

MIT