gitui-view 0.1.0

A terminal-based Git repository browser with inline and side-by-side diff views
gitui-view-0.1.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.

Features

  • Status Tab — View staged and unstaged file changes
  • Log Tab — Browse commit history with author, timestamp, and summary
  • Stashes Tab — List and inspect stashed changes
  • Diff View — Review diffs in inline or side-by-side mode, with syntax highlighting
  • 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, tab switching, and quick-jump keys

Keybindings

Key Action
q Quit
h Toggle help
d Toggle diff view
m Toggle inline / side-by-side diff mode
Tab / ← → Switch tabs
1 2 3 Go to Status / Log / Stashes tab
↑ ↓ / k j Navigate list / scroll diff
Enter Show file list for commit/stash, or show diff for file
Esc Go back

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.