tij 0.3.28

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 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 / Help / Operation History / Blame (with Log jump) / Bookmark
History Editing Describe (d quick edit / Ctrl+E external editor) / Edit / New / New from selected / Commit / Squash / Abandon / Split / Rebase (revision/source/insert-after/insert-before) / Absorb
Conflict Resolution Resolve List View / :ours / :theirs / External merge tool / Conflict jump
Recovery Undo / Redo / Operation Restore
Bookmarks Create / Move (with confirmation) / Delete (multi-select) / Rename / Forget / Track / Untrack / Jump / Bookmark View (M)
Git Integration Fetch (multi-remote selection) / Push (with dry-run preview, force push warnings, protected bookmark detection, multi-remote selection, and push-by-change)
Navigation Next/Prev (]/[ to move @ through history) / Reversed log order (V)
Diff Compare two revisions (jj diff --from --to)
Usability Revset filtering / Text search / Adaptive status bar / Dynamic context-aware hints / --limit 200 default (unlimited with revset)

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 (458), Integration (75+), Snapshot (17), Property-based (15)

Acknowledgments

License

MIT