diff-tui 0.1.1

A terminal-based Git diff viewer with fuzzy search
diff-tui-0.1.1 is not a library.

diff-tui

A terminal-based Git diff viewer. Provides an intuitive interface for browsing changed files and viewing diffs.

Features

  • File Selection: Browse changed files in your Git repository
  • Fuzzy Search: Press / to filter files by name
  • Colored Diff: Uses delta or git diff for syntax-highlighted diffs
  • Status Indicators: M(modified), A(added), D(deleted), R(renamed), ?(untracked)

Requirements

  • Rust 1.70+
  • Git

Optional

  • delta - Enhanced diff output (falls back to git diff if not installed)

Installation

From crates.io:

cargo install diff-tui

From source:

git clone https://github.com/chouxcreams/diff-tui
cd diff-tui
cargo install --path .

Configuration

Create ~/.config/diff-tui/config.toml to customize settings:

[diff]
# Diff tool to use (default: "auto")
# Options: "auto", "delta", "diff-so-fancy", "difftastic", "colordiff", "git"
# Or specify any custom command name
tool = "delta"

# Additional arguments to pass to the diff tool (optional)
args = ["--side-by-side"]

[editor]
# Editor command (default: $EDITOR environment variable, then "vi")
command = "nvim"

# Additional arguments to pass to the editor (optional)
args = []

Diff Tool Behavior

Value Behavior
"auto" Try delta first, fall back to git diff (default)
"delta" Use delta (falls back to git diff if not installed)
"git" Use git diff directly
Other Use specified command (falls back to git diff if not found)

Usage

Run inside a Git repository:

diff-tui

Key Bindings

File Selection

Key Action
j / ↓ Move to next file
k / ↑ Move to previous file
Enter View diff of selected file
e Open file in editor
/ Start search mode
q Quit

Search Mode

Key Action
Type Add to search query
Backspace Delete character
Enter View diff of selected file
Esc Cancel search
↑ / ↓ Navigate search results

Diff View

Key Action
j / ↓ Scroll down 1 line
k / ↑ Scroll up 1 line
d / PageDown Scroll down 20 lines
u / PageUp Scroll up 20 lines
g / Home Go to top
G / End Go to bottom
e Open file in editor
Esc Return to file selection
q Quit

Tech Stack

License

MIT