# gitstack
Git Activity Stack TUI - A viewer focused on history comprehension and context awareness.
[日本語版 / Japanese](README.ja.md)
## Overview
gitstack visualizes Git history as an "event stack". It displays commits, merges, branch switches, and other events stacked in chronological order (newest first), allowing you to grasp the repository flow at a glance.
## Features
- **Fast startup and rendering** - Designed with lightweight operation and rendering speed as top priorities
- **Event stack display** - Intuitive visualization of Git history as a stack structure
- **Flat operation model** - Simple key operations without mode switching
- **Viewer-focused design** - Delegates destructive operations to CLI or AI tools, focusing on history comprehension
## Installation
```bash
cargo install gitstack
```
Or build from source:
```bash
git clone https://github.com/Hiro-Chiba/gitstack.git
cd gitstack
cargo build --release
```
## Key Bindings
| `j` / `k` | Move up/down |
| `g` / `G` | Go to top/bottom |
| `Enter` | Show detail |
| `/` | Filter |
| `s` | Status view (staging) |
| `c` | Quick commit |
| `b` | Branch select |
| `t` | Topology view |
| `r` | Fetch remote |
| `?` | Help |
| `q` | Quit |
## Documentation
- [Design Document](docs/DESIGN.md) - Detailed design principles and technical specifications (Japanese)
## License
MIT