# gitstack
[](https://crates.io/crates/gitstack)
[](LICENSE)
**Git history viewer focused on analysis and insights**
```
┌─ gitstack ── myproject (main) ─────────────────────────────┐
│ ● abc123 feat: add auth John 2h ago +45 -12 │
│ ○ def456 fix: login bug Jane 5h ago +3 -1 │
│ ◆ ghi789 Merge: feature John 1d ago │
└────────────────────────────────────────────────────────────┘
```
## Install & Run
```bash
cargo install gitstack
cd your-repo
gitstack
```
## What makes it different?
While **tig/lazygit** focus on git operations, gitstack focuses on **understanding your codebase**:
- `A` - Who contributed what? (Author stats)
- `H` - Which files change most? (Heatmap)
- `T` - When does the team commit? (Timeline)
- `O` - Who owns this code? (Ownership)
- `t` - Any stale branches? (Topology + health)
## Basic Keys
| `j/k` | Navigate |
| `Enter` | Show diff |
| `P` | Show file patch (in detail view) |
| `/` | Filter (try `/author:john`, `/since:7days`, `/hash:abc..def`) |
| `?` | Full help |
| `q` | Quit |
---
[日本語版](README.ja.md) · [Design Doc](docs/DESIGN.md)