Histograph is a colorful, intuitive CLI tool that helps you track your local coding activity and Git repository statistics. Whether you're curious about your most active coding hours or need insights into repository-level stats, Histograph has you covered.
As a developer, I’ve always found GitHub’s contribution graph incredibly motivating , seeing those green squares fill up makes me feel productive and consistent. It’s a simple but powerful way to stay on track and celebrate progress So I thought: why not bring that same motivation directly into my terminal? and that’s why I built Histograph : local stats, colorful graphs, and motivation right where I code
- ⏱ Track Coding Hours: Automatically logs your coding activity and provides daily stats.
- 📊 Repository Stats: Analyze Git repository statistics by email.
- 📧 Commits Analysis: Visualise your commit histories for specific email via a colorful graph.
- 📂 Folder Scanning: Add and track multiple repositories with a single command.
- 🌟 Interactive Curve Graphs: Visualize your coding activity with intuitive ASCII graphs.
- Java 17 or later.
- Maven for dependency management.
- A love for coding stats! ❤️
- Clone the repository:
git clone https://github.com/TayssirGh/Histograph.git cd Histograph/hgraph/ - Build the project::
mvn clean package
- Run the setup script::
./setup.sh
- Verify installation:
hgraph
The monitor.sh script tracks your coding hours by detecting when your favorite IDE (default: idea) is running. It logs your activity in ~/.monitor.log
💡 To enable it as a background service:
sudo ./setup_service.shCheck its status:
systemctl status process-monitor.service- Unit Tests: Built with JUnit and Mockito.
- Run tests with:
mvn test- Build Native Image (optional, requires GraalVM):
mvn package -PnativeMay your terminal be colorful, your commits frequent, and your coffee always warm. ☕💻