tuit

tuit is a terminal-based Git log viewer built with Rust and ratatui.

It opens the Git repository at the current directory and displays a scrollable list of commits on the current branch. Select a commit to view its full body and diff in an overlay. All operations are keyboard-driven.

cargo install tuit-bin

• Rust toolchain (edition 2024, Rust 1.85+ recommended)

git clone https://github.com/yoshikikudo/tuit.git
cd tuit
cargo build --release

The binary will be placed at target/release/tuit. Copy it to a directory in your $PATH if desired.

Simply run tuit inside a Git repository.

cd /path/to/your/repo
tuit

• Commit list: Shows abbreviated hash (7 characters), commit subject, author name, and relative timestamp (3d ago / 2h ago etc.) for each commit.
• Commit detail: Shows the selected commit's hash, author, date, full body, and a colorized unified diff. Added lines, deleted lines, and context lines are each color-coded.
• Live sync: Polls the Git repository every 2 seconds while running, automatically detecting new commits and HEAD changes. When HEAD moves, the footer turns solid blue with a centered notification. The commit list is automatically reloaded.
• Error screen: Shows an error message when run outside a Git repository, inside an empty repository, or against a broken .git directory.

Place your config file at ~/.config/tuit/config.toml. Theme files go under ~/.config/tuit/themes/.

theme = "monokai"
poll_interval_ms = 3000
notification_timeout_ms = 5000

The default theme is a dark theme based on Catppuccin Mocha. To customize, create a theme file at ~/.config/tuit/themes/<name>.toml and set theme = "<name>" in your config.

Customizable fields:

• cursor_bg, cursor_fg — selected row highlight colors
• list_bg — list view background
• hash, message, author, date — field-specific text colors
• detail_bg, detail_border — detail overlay background and border
• detail_heading, detail_value — detail heading and value colors
• diff_add, diff_del, diff_normal — diff line colors (added, deleted, context)

• Language: Rust (edition 2024)
• UI framework: ratatui + crossterm
• Git data access: gix (gitoxide) — pure Rust, no git CLI dependency
• Diff generation: imara-diff
• Config management: TOML + directories (XDG-compliant path resolution)

MIT License — see LICENSE for details.