keifu
| Crates.io | keifu |
| lib.rs | keifu |
| version | 0.2.2 |
| created_at | 2025-12-20 03:17:14.08125+00 |
| updated_at | 2026-01-15 14:11:36.811619+00 |
| description | A TUI tool to visualize Git commit graphs with branch genealogy |
| homepage | |
| repository | https://github.com/trasta298/keifu |
| max_upload_size | |
| id | 1995951 |
| size | 484,994 |
trasta (trasta298)
documentation
README
𧬠keifu
keifu (η³»θ, /keΛΙΈΙ―/) is a terminal UI tool that visualizes Git commit graphs. It shows a colored commit graph, commit details, and a summary of changed files, and lets you perform basic branch operations.
Motivation
- Readable commit graph β
git log --graphis hard to read; keifu renders a cleaner, color-coded graph - Fast branch switching β With AI-assisted coding, working on multiple branches in parallel has become common. keifu makes branch switching quick and visual
- Keep it simple β Only basic Git operations are supported; this is not a full-featured Git client
- Narrow terminal friendly β Works well in split panes and small windows
- Sixel support β Compatible with Windows Terminal and other Sixel-capable terminals
Features
- Unicode commit graph with per-branch colors
- Commit list with branch labels, date, author, short hash, and message (some fields may be hidden on narrow terminals)
- Commit detail panel with full message and changed file stats (+/-)
- Git operations: checkout, create/delete branch, fetch
- Branch search with dropdown UI
Requirements
- Run inside a Git repository (auto-discovery from current directory)
- A terminal with Unicode line drawing support and color
gitcommand in PATH (required for fetch)- Rust toolchain (for building from source)
Installation
From crates.io
cargo install keifu
From source
cargo install --path .
Or:
cargo build --release
./target/release/keifu
Usage
Run inside a Git repository:
keifu
Configuration
See docs/configuration.md for configuration options.
Keybindings
Navigation
| Key | Action |
|---|---|
j / β |
Move down |
k / β |
Move up |
] / Tab |
Jump to next commit that has branch labels |
[ / Shift+Tab |
Jump to previous commit that has branch labels |
h / β |
Select left branch (same commit) |
l / β |
Select right branch (same commit) |
Ctrl+d |
Page down |
Ctrl+u |
Page up |
g / Home |
Go to top |
G / End |
Go to bottom |
@ |
Jump to HEAD (current branch) |
Git operations
| Key | Action |
|---|---|
Enter |
Checkout selected branch/commit |
b |
Create branch at selected commit |
d |
Delete branch (local, non-HEAD) |
f |
Fetch from origin |
Search
| Key | Action |
|---|---|
/ |
Search branches (incremental fuzzy search) |
β / Ctrl+k |
Select previous result |
β / Ctrl+j |
Select next result |
Enter |
Jump to selected branch |
Esc / Backspace on empty |
Cancel search |
Other
| Key | Action |
|---|---|
R |
Refresh repository data |
? |
Toggle help |
q / Esc |
Quit |
Notes and limitations
- The TUI loads up to 500 commits across all branches.
- Merge commits are diffed against the first parent; the initial commit is diffed against an empty tree.
- Changed files are capped at 50 and binary files are skipped.
- If there are staged or unstaged changes (excluding untracked files), an "uncommitted changes" row appears at the top.
- When multiple branches point to the same commit, the label is collapsed to a single name with a
+Nsuffix (e.g.,main +2). Useh/lorβ/βto switch between them. - Checking out
origin/xxxcreates or updates a local branch. Upstream is set only when creating a new branch. If the local branch exists but points to a different commit, it is force-updated to match the remote. - Remote branches are displayed, but delete operations only work with local branches.
- Fetch requires the
originremote to be configured.
License
MIT