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

Usage

Run inside a Git repository:

diff-tui

Key Bindings

File Selection

Search Mode

Diff View

Tech Stack

• Ratatui - TUI framework
• git2 - Git operations
• nucleo - Fuzzy matching
• ansi-to-tui - ANSI escape sequence parsing

License

MIT