gitpulse ⚡

Advanced git activity tracker with AI-powered insights, streaks, heatmaps, goals & more. Works on Linux, Windows, and Android (Termux).

  ░██████╗░██╗████████╗██████╗░██╗   ██╗██╗░░░░░░██████╗███████╗
  ██╔════╝░██║╚══██╔══╝██╔══██╗██║   ██║██║░░░░░██╔════╝██╔════╝
  ██║░░██╗░██║░░░██║░░░██████╔╝██║   ██║██║░░░░░╚█████╗░█████╗░░
  ██║░░╚██╗██║░░░██║░░░██╔═══╝░██║   ██║██║░░░░░░╚═══██╗██╔══╝░░
  ╚██████╔╝██║░░░██║░░░██║░░░░░╚██████╔╝███████╗██████╔╝███████╗

Features

• 🔥 Streak tracking — current streak, longest streak, committed today
• 📊 ASCII heatmap — full year contribution graph in your terminal
• 😴 Days off analysis — total off days, longest break, last day off
• 🧠 AI insights — powered by Claude. Analyzes your habits, flags bad commit patterns, gives improvement tips
• ✍️ Commit improver — paste any bad commit message, get a better one instantly
• 🏆 Leaderboard — track your stats over time or compete with others
• 🎯 Goals — set daily/weekly/streak goals with AI-assisted feedback
• 📁 Multi-repo — track all your repos: personal, forked, contributed
• 🌍 Cross-platform — Linux, Windows (PowerShell/CMD), Android (Termux)

Installation

Prerequisites

• Node.js 18+
• Git

Install

# Clone the repo
git clone https://github.com/you/gitpulse
cd gitpulse

# Install dependencies
npm install

# Make it globally available
npm link

Android (Termux)

pkg install nodejs git
npm install -g gitpulse

Windows

# Run in PowerShell as Administrator
npm install -g gitpulse

Usage

# Full dashboard (streaks, heatmap, quality, goals)
gitpulse stats

# AI-powered analysis and commit improvement tips
gitpulse insights

# Browse commit history
gitpulse history
gitpulse history --days 60 --limit 100

# Improve a specific commit message with AI
gitpulse improve "fix stuff"
gitpulse improve "update code"

# Set your coding goals (with AI feedback)
gitpulse goals --set

# Manage tracked repos
gitpulse repos --add              # add current folder
gitpulse repos --add /path/repo   # add specific repo
gitpulse repos --remove /path     # remove a repo
gitpulse repos                    # list all

# First-time setup (recommended)
gitpulse setup

# Leaderboard
gitpulse leaderboard

Commands

| Command | Description | |---|---| | gitpulse | Same as stats | | gitpulse stats | Full dashboard | | gitpulse stats --all | Include all tracked repos | | gitpulse stats --verbose | Include recent commit list | | gitpulse insights | AI analysis & improvement tips | | gitpulse improve "<msg>" | AI-improve a commit message | | gitpulse history | Commit history grouped by day | | gitpulse goals | View goals | | gitpulse goals --set | Set goals interactively | | gitpulse leaderboard | View stats leaderboard | | gitpulse repos | Manage tracked repos | | gitpulse setup | First-time setup wizard |

AI Features

gitpulse uses Claude AI (via the Anthropic API) for:

1. Commit quality scoring — each commit is scored 0–100 locally
2. AI deep analysis — Claude reads your recent commits and gives:
   • Honest summary of your habits
   • Strengths and weaknesses
   • Before/after examples of bad commit messages
   • Specific action items
3. Commit improver — transforms any vague message into a proper conventional commit
4. Goal advisor — assesses whether your goals are realistic based on your history

The AI features work automatically. No API key needed when running in the Claude environment.

Commit Quality Scoring

Each commit message is scored locally:

| Issue | Penalty | |---|---| | Too short (<10 chars) | -40 | | Vague word (fix, update, misc) | -25 | | No conventional commit type | -20 | | All caps | -15 | | "fix" with no detail | -20 |

Score guide:

• 70–100 ✅ Good
• 40–69 ⚠️ Needs improvement
• 0–39 ❌ Poor

Config

Config is stored at ~/.gitpulse/config.json:

{
  "repos": ["/home/user/projects/myapp"],
  "author": "yourname",
  "goals": {
    "dailyCommits": 2,
    "weeklyCommits": 10,
    "streakTarget": 30,
    "yearlyActiveDays": 250
  },
  "leaderboard": []
}

Cross-Platform Notes

• Windows: Uses \r\n line endings, colors work in Windows Terminal and PowerShell 7+
• Android/Termux: Works natively. Install with pkg install nodejs git
• Linux: Full support

License

MIT