cliory

A terminal UI for exploring git history. Renders your commit graph with colored branch lanes, search, and a detail pane — all in your terminal.

Features

• Interactive graph view — scroll through commit history rendered with Unicode box-drawing characters and per-column branch coloring
• Detail pane — select any commit to see full metadata (author, date, message, file stats)
• Search — press / to search commit messages and hashes, navigate matches with n/N
• Mouse support — scroll wheel works out of the box
• Dual focus mode — Tab to toggle between graph navigation and detail scrolling
• Vim-style bindings — j/k, g/G, / search, q quit
• Live refresh — press r to re-read the commit log

Installation

git clone https://github.com/praneshnikhar/cliory.git
cd cliory
cargo build --release

Then run from any git repo:

./target/release/cliory

Or install globally:

cargo install --path .

Usage

Key         Action
─────────────────────────────
j / ↓       Navigate down
k / ↑       Navigate up
g           Go to top
G           Go to bottom
/           Search commits
n / N       Next / previous match
Tab         Toggle graph / detail focus
d           Toggle detail pane
r           Refresh commit log
?           Show help
q / Ctrl+C  Quit

How it works

cliory shells out to git log --all --graph --oneline --decorate to get the commit graph, parses the output to extract commit metadata and column positions, then renders it with ratatui. Each column slot gets a distinct color, and Unicode box-drawing characters replace the ASCII graph for a cleaner look.

The detail pane fetches git log -1 --format=fuller --stat on demand, cached per commit.

Dependencies

• ratatui — terminal UI framework
• crossterm — terminal backend
• anyhow — error handling

License

MIT