README
¶
🌀 gitpulse
gitpulse is an open-source CLI tool for instantly analyzing Git repository statistics — including contributor activity, commit patterns, and directory heat — right from your terminal.
It supports both command-line and interactive terminal UI (TUI) modes for a seamless developer experience.
✨ Features
- 📊 Repository Summary
Total commits, unique contributors, first & last commits, average commits/day - 🧑💻 Top Contributors
Most active committers, ranked by number of commits - 🔥 Commit Activity Heatmap
Visualize commit frequency by weekday - 📂 Most Active Directories
See which folders change the most - 🧪 TUI Mode
Interactive, keyboard-navigable terminal interface with tabs
⚙️ Installation
Requires Go 1.21+ installed
🚀 Quick Install (Recommended for Developers)
You can install the latest version directly with Go:
go install github.com/Mertozturkk/gitpulse@latest
Make sure your Go bin directory is in your PATH (usually $HOME/go/bin):
export PATH="$PATH:$(go env GOPATH)/bin"
🧱 Build from Source
Linux & macOS
git clone https://github.com/Mertozturkk/gitpulse.git
cd gitpulse
go build -o gitpulse
Windows
git clone https://github.com/Mertozturkk/gitpulse.git
cd gitpulse
go build -o gitpulse.exe
🚦 Usage
Run from the root of a Git repository:
🔹 Summary
gitpulse summary
🔹 Top Contributors
gitpulse authors --top 5
🔹 Commit Heatmap
gitpulse heatmap --since 30d
🔹 Active Directories
gitpulse dirs
🔹 Interactive Terminal UI (TUI)
gitpulse tui
• Navigate tabs with ← → arrows
• Press q to quit
🔹 Help
gitpulse --help
🛠️ Contributing
Pull requests and issues are welcome!
Please read CONTRIBUTING.md for details on how to contribute.
- Fork the repository
- Create a feature branch
- Open a pull request
- Describe your changes clearly
📦 Versioning & Releases
This project uses semantic versioning for long-term maintainability.
You can always install the latest stable version with the @latest tag using Go, or check Releases for versioned binaries in the future.
License
This project is licensed under the MIT License.
Developed by Mertozturkk
Documentation
Source Files
Directories