https://github.com/tayssirgh/histograph
Histograph is a CLI tool for tracking Git repository activity and coding hours, offering insights into productivity and workflow patterns.
https://github.com/tayssirgh/histograph
bash cli java picocli
Last synced: 4 months ago
JSON representation
Histograph is a CLI tool for tracking Git repository activity and coding hours, offering insights into productivity and workflow patterns.
- Host: GitHub
- URL: https://github.com/tayssirgh/histograph
- Owner: TayssirGh
- License: mit
- Created: 2024-12-03T11:27:45.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-19T19:02:41.000Z (8 months ago)
- Last Synced: 2025-10-20T02:20:30.548Z (8 months ago)
- Topics: bash, cli, java, picocli
- Language: Java
- Homepage:
- Size: 63.5 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# **Histograph**
**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.
## 🔍 Motivation
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
## 🚀 Features
- ⏱ **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.
---
## 🛠 Setup and Installation
### Prerequisites
- **Java 17** or later.
- **Maven** for dependency management.
- A love for coding stats! ❤️
### Installation Steps
1. **Clone the repository**:
```bash
git clone https://github.com/TayssirGh/Histograph.git
cd Histograph/hgraph/
2. **Build the project:**:
```bash
mvn clean package
3. **Run the setup script:**:
```bash
./setup.sh
4. **Verify installation:**
```bash
hgraph
If you see the Histograph ASCII logo, you're all set! 🎉
---
## 🛡 Monitoring Your Coding Activity
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:
```bash
sudo ./setup_service.sh
```
Check its status:
``` bash
systemctl status process-monitor.service
```
---
## 🔬 Development and Testing
* Unit Tests: Built with JUnit and Mockito.
* Run tests with:
``` bash
mvn test
```
* Build Native Image (optional, requires GraalVM):
```bash
mvn package -Pnative
```
### Thanks for Dropping By! 🙌
May your terminal be colorful, your commits frequent, and your coffee always warm. ☕💻