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! ❤️

1. Clone the repository:

   git clone https://github.com/TayssirGh/Histograph.git
   cd Histograph/hgraph/

2. Build the project::

   mvn clean package

3. Run the setup script::

    ./setup.sh

4. 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.sh

Check 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 -Pnative

May your terminal be colorful, your commits frequent, and your coffee always warm. ☕💻