🧬 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 --graph is hard to read; keifu renders a cleaner, color-coded graph
• Fast branch switching — With the rise of vibe 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
• No image protocol required — Works on any terminal with Unicode support

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 (+/-)
• File diff view with syntax highlighting and word-level change emphasis
• 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
• git command in PATH (required for fetch)
• Rust toolchain (for building from source)

Installation

From crates.io

cargo install keifu

With mise

mise use -g github:trasta298/keifu@latest

With Homebrew

brew install trasta298/tap/keifu

From source

git clone https://github.com/trasta298/keifu && cd keifu && cargo install --path .

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)
Space	Open file diff view

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

File diff view

Key	Action
j / k / ↑ / ↓	Scroll up/down
h / l / ← / →	Scroll left/right
Ctrl+d / Ctrl+u	Half-page down/up
Ctrl+f / Ctrl+b	Full page down/up
g / G	Go to top/bottom
0	Scroll to line start
] / [	Jump to next/previous hunk
n / N	Jump to next/previous file
Esc / q	Back to file select / close

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. Binary files are shown without line stats.
• If there are staged, unstaged, or untracked changes, 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 +N suffix (e.g., main +2). Use h/l or ←/→ to switch between them.
• Checking out origin/xxx creates 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 origin remote to be configured.

License

MIT