https://github.com/hjr265/gittop
A beautiful terminal UI for visualizing Git repository statistics, inspired by htop/btop.
https://github.com/hjr265/gittop
bubbletea cli data-visualization developer-tools git git-stats go-git golang lipgloss terminal terminal-ui tui
Last synced: 3 days ago
JSON representation
A beautiful terminal UI for visualizing Git repository statistics, inspired by htop/btop.
- Host: GitHub
- URL: https://github.com/hjr265/gittop
- Owner: hjr265
- License: bsd-3-clause
- Created: 2026-03-12T19:35:48.000Z (25 days ago)
- Default Branch: master
- Last Pushed: 2026-03-28T08:52:10.000Z (9 days ago)
- Last Synced: 2026-03-28T13:11:26.408Z (9 days ago)
- Topics: bubbletea, cli, data-visualization, developer-tools, git, git-stats, go-git, golang, lipgloss, terminal, terminal-ui, tui
- Language: Go
- Homepage:
- Size: 1.15 MB
- Stars: 102
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GitTop
A beautiful terminal UI for visualizing Git repository statistics, inspired by htop/btop.
Prototyped rapidly with an agentic coding tool. Read the [blog post](https://hjr265.me/blog/building-gittop-with-agentic-coding/).
## Install
### Arch Linux (AUR)
``` sh
yay -S gittop
```
### Homebrew
``` sh
brew install hjr265/gittop/gittop
```
### Go
``` sh
go install github.com/hjr265/gittop@latest
```
Or build from source:
``` sh
git clone https://github.com/hjr265/gittop.git
cd gittop
go build -o gittop .
```
## Usage
``` sh
gittop # visualize the current directory's Git repo
gittop /path/to/repo
```
When no path is given, GitTop also respects the `GIT_DIR` and `GIT_WORK_TREE` environment variables.
## Tabs
| # | Tab | What it shows |
|---|-----|---------------|
| 1 | **Summary** | KPI cards (total commits, active days, peak day, time span, latest release) + area chart (braille or block) |
| 2 | **Activity** | Heatmap, by-hour, by-weekday, by-month distributions |
| 3 | **Contributors** | Split panel: ranked list (left) + per-author detail with cadence, schedule, top files (right) |
| 4 | **Branches** | Sortable table with last commit, author, ahead/behind counts |
| 5 | **Files** | Largest files, most churn, most authors, stalest files, language breakdown |
| 6 | **Releases** | Tag timeline and release cadence chart |
| 7 | **Commits** | Scrollable commit log with diff viewer and search |
## Screenshots
| | |
|---|---|
|  |  |
|  |  |
|  |  |
## Keys
| Key | Action |
|-----|--------|
| `1`–`7` | Switch tab |
| `Tab` / `Shift+Tab` | Next / previous tab |
| `+` / `-` | Widen / narrow date range (3m, 6m, 1y, 2y, 5y, all) |
| `/` | Open global filter (`author:"name"`, `path:*.go`, `branch:main`, `"keyword"`, `and`/`or`/`not`) |
| `Esc` | Clear filter or page-local search |
| `r` | Refresh (re-scan repository) |
| `d` / `w` / `m` / `y` | Chart granularity: daily, weekly, monthly, yearly (Summary) |
| `v` | Cycle sub-views (Activity, Contributors, Files, Releases) |
| `f` | File path filter (Files tab) |
| `s` / `S` | Sort column / toggle order (Branches); search (Commits) |
| `j` / `k` | Scroll down / up |
| `g` / `G` | Jump to top / bottom |
| `Enter` | Open commit diff (Commits) |
| `o` | Open options menu (color theme, truecolor, graph symbol) |
| `q` | Quit |
## Recommended Setup
For best results with the block character bar charts:
- **Terminal:** Kitty, Alacritty, or WezTerm
- **Font:** JetBrains Mono, Iosevka, or Fira Code
## License
BSD 3-Clause License. See [LICENSE](LICENSE) for details.