gitui-view 0.2.0

A terminal-based Git repository browser with inline and side-by-side diff views
gitui-view-0.2.0 is not a library.

gitui-view

crates.io docs.rs License

A terminal-based Git repository browser with inline and side-by-side diff views, built with ratatui.

demo

gitui-view is a lite version of gitui, drawing inspiration from delta for diff rendering. It focuses on the core Git browsing experience — status, log, stashes, and diff review — with a clean and minimal interface.

Features

  • Status Tab — View staged and unstaged file changes with file-level diff panel
  • Log Tab — Browse commit history with 4-level depth navigation:
    • Level 1 (Commits) — Full-screen commit list
    • Level 2 (Details) — Commit list + commit details & file list side-by-side
    • Level 3 (FilesDiff) — Commit details & file list + file diff side-by-side
    • Level 4 (Diff) — Full-screen diff view
  • Stashes Tab — List and inspect stashed changes with the same 4-level depth navigation
  • Diff View — Review diffs in inline or side-by-side mode, with syntax highlighting and binary file size display
  • Auto Theme Detection — Automatically picks light or dark theme based on your terminal color scheme
  • Custom Themes — Load custom themes via RON files
  • Keyboard-driven — Vim-style navigation with j/k, depth-based tab navigation, and quick-jump keys

Keybindings

Key Action
q Quit
h Toggle help
Tab / Shift+Tab Switch tabs (Status ↔ Log ↔ Stashes)
1 / 2 / 3 Go to Status / Log / Stashes tab
↑ ↓ / k j Navigate list / scroll diff
Enter / → Enter next level (List → Details → FilesDiff → Diff)
Esc Return to previous level
← Status tab: switch between staged/unstaged panel
d Enter / exit diff view (context-dependent)
f Toggle fullscreen diff
m Toggle inline / side-by-side diff mode
PageUp / PageDown Scroll diff by page
Home / End Go to diff top / bottom

Usage

# Open the repository in the current directory
gitui-view

# Open a specific repository
gitui-view /path/to/repo

# Use a custom theme file
gitui-view --theme my_theme.ron

Installation

From crates.io

cargo install gitui-view

From source

git clone https://github.com/lyj-514328/gitui-view.git
cd gitui-view
cargo install --path .

Configuration

Themes can be customized via RON files. See the built-in light and dark themes in src/theme.rs for available fields.

gitui-view --theme ~/.config/gitui-view/theme.ron

Dependencies

License

Licensed under the MIT License. See LICENSE for details.