Keep your GitHub streak green with a lightweight, cross-platform tool.
Automatically checks your daily commits โ both public (GitHub) and local (git) โ with smart path detection ๐ง โ๏ธ
- โ AI-like Personalization - Learns your coding patterns without ML dependencies
- โ
 Commit Message Coaching (--coach) - Suggests improvements based on your style
- โ Tech Stack Detection - Auto-detects Python, JS/React, Rust, Java, etc.
- โ Project Structure Analysis - Suggests tests, documentation updates
- โ Stack-aware Suggestions - Django migrations, npm installs, cargo checks
- โ
 Personal Insights (--insights) - Analyze your coding habits and trends
- โ Non-disruptive - Suggestions only, never blocks your workflow
- โ Sound Notifications - Audio feedback for completion and suggestions
- โ Achievement System - Unlock badges with ASCII art (Common to Mythic rarity)
- โ XP & Level System - Earn XP from commits, progress through 10 levels
- โ Streak Tracking - Daily commit streaks with automatic achievement unlocking
- โ Visual Progress - Unicode progress bars and level-up celebrations
- โ Smart XP Calculation - Based on lines changed, deletions, and project weights
- โ Configurable Weights - Set different XP multipliers per project
- โ ASCII Commit Heatmap - GitHub-style activity visualization (365 days)
- โ Language Breakdown - Analyze coding languages across repositories
- โ SVG Export - Export heatmaps for sharing and documentation
- โ Dynamic Mood System - Smart status messages based on activity
- โ Visual Charts - Unicode bar charts and activity indicators
- โ Template System - 5 built-in templates (bugfix, feature, concept, tool, algorithm)
- โ Individual Files - Each TIL entry as separate markdown file
- โ Fuzzy Search - Search entries with highlighted matches and scoring
- โ Auto-generation - Generate TIL entries from git commit diffs
- โ Tag Organization - Automatic tag extraction and filtering
- โ Vault Management - Comprehensive statistics and organization
- โ Smart auto-detection of git repositories
- โ Cross-platform support (macOS, Linux, Windows)
- โ Multiple development folders monitoring
- โ GitHub public & private commits tracking
- โ Repository scanning and commit analysis
- โ Most active repo detection (daily, weekly, monthly)
- โ
 Interactive Setup Wizard (--init) with guided configuration
- โ Smart Path Detection - automatically finds your dev folders
- โ Theme Selection - tech, kawaii, anime, horror, or default themes
- โ Custom Commit Rules - regex patterns for commit message validation
- โ Pre-commit Hook Installation - optional Git hook setup
- โ
 ASCII Commit Charts (--stats) showing 30-day trends
- โ Visual Repository Analysis with Unicode bar charts (โโโโโ โโโ)
- โ Multi-Repository Stats across all local repositories
- โ Recent Activity Summary with detailed commit breakdowns
- โ
 Repository Scanning (--scan) with commit analysis
- โ
 System Diagnostics (--diagnose) for troubleshooting
- โ Installation Method Detection (pip, pipx, standalone)
- โ Dependency Verification and environment analysis
- โ Configuration Validation with automatic migration
- โ No pip installation issues - works with any Python setup
- โ One-line installation with curl/bash
- โ Intelligent Update System with version caching
- โ PEP 668 Compliance - handles externally managed environments
- โ Complete uninstall functionality with smart cleanup
v0.6.1 Update: If you're experiencing uninstall issues or missing commands from v0.6.0, the latest version fixes all known issues including complete cleanup and standalone feature parity.
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bashcurl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh -o /tmp/install.sh
chmod +x /tmp/install.sh
/tmp/install.shcurl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bashcurl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/commit-checker-standalone.sh -o /tmp/commit-checker.sh
chmod +x /tmp/commit-checker.sh
/tmp/commit-checker.shcurl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/install.sh | bashOn first run, commit-checker intelligently detects your development setup:
๐ Found these potential development folders:
   1. Current directory: /Users/you/project (git repo)
   2. /Users/you/Documents/GitHub (15 git repos found)
   3. /Users/you/Developer (8 git repos found)
   Or enter a custom path
   (Default: /Users/you/Documents/GitHub)
๐ Enter number (1-3), custom path, or press Enter for default:Basic usage:
commit-checkerAll available commands:
Setup & Configuration:
- commit-checker --init- Interactive setup wizard (recommended for first-time users)
- commit-checker --setup- Quick reconfigure settings
- commit-checker --diagnose- Run system diagnostics
๐ง Smart Profile System (v0.7.0):
- commit-checker --build-profile- Build/rebuild your personalized coding profile
- commit-checker --coach "fix user auth"- Get commit message coaching suggestions
- commit-checker --feedback good/bad- Give feedback on coaching suggestions to tune preferences
- commit-checker --insights- Show personalized coding insights and habits
- commit-checker --no-profile- Skip profile-based suggestions for this run
Core functionality:
- commit-checker- Check today's commits with gamification
- commit-checker --scan- Scan repo folder for all git repositories
- commit-checker --repos-summary- Show full summary of all repos
- commit-checker --most-active- Show most active repository today
- commit-checker --most-active --week- Show most active repo this week
- commit-checker --most-active --month- Show most active repo this month
- commit-checker --stats- Show ASCII commit trend charts (30 days)
๐ฎ Gamification & Progress:
- commit-checker --achievements- Display achievement gallery with ASCII art
- commit-checker --xp- Show current XP, level, and progress to next level
- Automatic streak tracking and achievement unlocking
- XP earned from commits based on lines changed and project weights
๐ Analytics & Visualizations:
- commit-checker --heatmap- Display ASCII commit heatmap (365 days)
- commit-checker --heatmap --days 90- Custom timeframe heatmap
- commit-checker --heatmap-export svg- Export heatmap to SVG file
- commit-checker --stats-lang- Programming language breakdown with charts
- commit-checker --time-stats- Commit timing analysis (morning/afternoon/evening/night)
- commit-checker --dashboard- Quick stats overview (commits today, streak, XP, top repo)
- commit-checker --suggest- Analyze latest commit message and suggest improvements
๐ Enhanced TIL (Today I Learned) Vault System:
- commit-checker til "Your learning today"- Add a TIL entry to log
- commit-checker til "Fixed bug" --template bugfix- Use template for vault entry
- commit-checker --list-templates- Show available TIL templates
- commit-checker --add-template NAME "STRUCTURE"- Create custom TIL templates
- commit-checker --til-vault- Show TIL vault summary with stats
- commit-checker --search-til "async"- Fuzzy search TIL entries
- commit-checker --til-from-diff- Generate TIL from latest commit changes
- commit-checker --view-til- View your complete TIL log
- commit-checker --view-til --filter-tag python- View TIL entries by tag
- commit-checker --edit-til- Edit TIL log in your default editor
- commit-checker --export md- Export TIL to Markdown file
- commit-checker --export json- Export TIL to JSON file
- commit-checker --reset-til- Clear all TIL entries (with confirmation)
- commit-checker til "Entry" --no-date- Add entry without date header
System commands:
- commit-checker --update- Manually check for updates
- commit-checker --uninstall- Remove completely (with PEP 668 support)
- commit-checker --uninstall --force- Remove without confirmation
- commit-checker --support- Show support info
- commit-checker --silent- Minimal output
- commit-checker --nocolor- Disable emojis/colors
macOS: ~/Documents/GitHub, ~/Developer, ~/Desktop/GitHub
Linux: ~/workspace, ~/devel, /var/www
Windows: ~/source, C:\Projects, C:\xampp\htdocs
commit-checker/
โโโ ๐ LICENSE.md                 # MIT License
โโโ ๐ README.md                  # This file
โโโ ๐ฆ setup.py                   # Python package setup (pip version)
โโโ ๐ requirements.txt           # Python dependencies
โโโ ๐ install.sh                 # Traditional pip installation
โโโ scripts/                      # Standalone versions
โ   โโโ ๐ฏ install-standalone.sh  # Standalone installer
โ   โโโ ๐ commit-checker-standalone.sh  # Standalone script
โโโ commit_checker/               # Core Python modules
    โโโ ๐ง __init__.py            # Package initialization
    โโโ โ
 checker.py             # Commit checking logic
    โโโ โ๏ธ config.py              # Configuration management
    โโโ ๐ path_detector.py       # Smart path detection
    โโโ ๐ updater.py             # Auto-update functionality
If this tool helps you stay consistent, focused, or productive โ consider supporting development!
Or visit: https://buymeacoffee.com/amariahak
Amariah Kamau
๐ GitHub: @AmariahAK
๐ Portfolio: https://portfolio-pied-five-61.vercel.app
Licensed under the MIT License.
Track your daily learnings with commit-checker's built-in TIL functionality:
# Add a learning entry
commit-checker til "Learned how to use async/await in Python"
# View your TIL log
commit-checker --view-til
# Edit in your preferred editor
commit-checker --edit-til# Today I Learned
## July 22, 2025
- Learned how to use async/await in Python
- Discovered that Git hooks can automate code quality checks
- Found out about the --no-ff flag in Git merge
## July 21, 2025
- Learned about CSS Grid layout properties
- Discovered Docker multi-stage builds for smaller images# Add entry without date grouping
commit-checker til "Quick tip" --no-date
# Reset all entries (with confirmation)
commit-checker --reset-tilTIL Storage: Entries are saved to ~/.commit-checker/til.md and persist between sessions unless manually deleted.
$ commit-checker
๐ GitHub: @AmariahAK
๐ข No public commits found today.
๐๏ธ  Scanning 1 local path(s):
   ๐ /Users/you/Documents/GitHub
๐ฉ Local Commits:
๐ Repository: commit-checker
   ๐ Path: /Users/you/Documents/GitHub/commit-checker
   ๐ 3 commit(s) today:
   e05feb7 feat: implement v0.6.1 - Critical Fixes & Enhanced Reliability
โก 3 commits today | +2305 XP | 1๐ฅ streak | ๐ Coding machine!
๐ซ +2305 XP earned today!
๐ LEVEL UP! You're now level 7!
๐ New achievements unlocked:
   ๐ฉ Hello World
   ๐จ Code Tsunami
๐ฅ Current streak: 1 days
$ commit-checker --xp
โก Level 7: Framework Knight
๐ซ Total XP: 4,499
๐ Progress: [โโโโโโโโโโโโโโโโโโโโ] 12.5%
๐ฏ Next Level: 3,501 XP needed
๐ Commits Tracked: 2
$ commit-checker --achievements
๐ Achievement Gallery
==================================================
๐ฉ COMMON BADGES
   ๐ฉ Hello World
   Made your first tracked commit
๐จ EPIC BADGES
   ๐จ Code Tsunami
   Single commit with 500+ line changes$ commit-checker --heatmap
๐
 Commit Heatmap (Last 365 days)
==================================================
01/28: โ โ โ โ โ โ โ
02/04: โ โ โ โ โ โ โ
...
07/20: โ โ โ โ โ โ โ
07/27: โ โ โ โ โ โ โ
Legend: โ None  โ Low  โ Medium  โ High
Max commits in a day: 5
Last 7 days: 12 commits
$ commit-checker --stats-lang
๐ Programming Language Breakdown
==================================================
Python          [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ]  54.1% (3,274 lines, 47 files)
JavaScript      [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ]  23.2% (1,405 lines, 23 files)
TypeScript      [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ]  13.1% (793 lines, 12 files)
CSS             [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ]   6.8% (412 lines, 8 files)
Markdown        [โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ]   2.8% (169 lines, 5 files)
๐ Total: 6,053 lines across 95 files$ commit-checker --list-templates
๐ Available TIL templates:
  โข algorithm
  โข bugfix
  โข concept
  โข feature
  โข tool
Usage: commit-checker til "Title" --template algorithm
$ commit-checker til "Fixed async race condition" --template bugfix
TIL created: /Users/you/.commit-checker/tils/2025-07-28-fixed-async-race-condition.md
$ commit-checker --til-vault
๐ TIL Vault Summary
==================================================
๐ Location: /Users/you/.commit-checker/tils/
๐ Total entries: 5
๐ Recent entries:
  โข 2025-07-28: Fixed async race condition #bugfix #async
  โข 2025-07-27: Implemented new caching layer #feature #performance
  โข 2025-07-26: Understanding Docker volumes #concept #docker
๐ท๏ธ  Popular tags:
  #bugfix (2)
  #feature (1)
  #concept (1)
$ commit-checker --search-til "async"
๐ Found 2 TIL entries:
==================================================
1. ๐ Fixed async race condition
   ๐
 2025-07-28 | Score: 10
   L1: # Fixed async race condition
   L15: - Used asyncio.Lock() to prevent race conditions
2. ๐ Understanding async patterns
   ๐
 2025-07-26 | Score: 5
   L8: - async/await syntax in Python$ commit-checker --init
๐งโโ๏ธ Welcome to commit-checker Interactive Setup Wizard!
๐ GitHub Configuration
   ๐ค GitHub username: AmariahAK
๐ Development Folder Configuration
   ๐ Found these potential development folders:
      1. /Users/you/Documents/GitHub (15 git repos found)
      2. /Users/you/Developer (8 git repos found)
๐จ Output Style Configuration
   1. ๐ Emoji mode (colorful with emojis)
   2. ๐ Plain mode (simple text only)
๐ TIL Configuration...
๐ Configuration saved!$ commit-checker --stats
๐ Commit Statistics (Last 30 Days)
==================================================
๐ commit-checker
   Total commits: 18
   Trend: โโโโโโโ
โโโโโโ
โโโโ
โโโโโโ
โโโโโ
โโโ
   Recent: 2025-07-23: 2, 2025-07-24: 3, 2025-07-25: 5
๐ my-website
   Total commits: 12
   Trend: โโโโโโ
โโโโโโ
โโโโโโโโโ
โโโโโโ
โโโโ
   Recent: 2025-07-23: 1, 2025-07-24: 2, 2025-07-25: 4$ commit-checker til "Learned about async/await in Python" --tag python
โ
 TIL entry added (tagged: python)
$ commit-checker --view-til --filter-tag python
# Today I Learned
## July 25, 2025
- Learned about async/await in Python `#python`
- Python decorators can modify function behavior `#python`
$ commit-checker --export json
๐ TIL exported to ~/til_export_20250725_143022.json$ commit-checker --diagnose
๐ System Diagnostics
==============================
๐ Python version: 3.11.5
๐ฆ Git: git version 2.39.0
๐ฆ Package: Installed via pip (v0.5.0)
โ๏ธ  Config: Found at ~/.commit-checker/config.json
   GitHub user: AmariahAK
   Local paths: 2 configured
   Output mode: emoji
๐ Dependencies:
   โ
 requests: Available
   โ
 packaging: Available
   โ
 colorama: Available
๐ Environment: Virtual environment
๐ฆ pipx: Available but commit-checker not installed via pipx
โ
 Diagnostics complete!$ commit-checker --scan
๐ Scanning /Users/you/Documents/GitHub for git repositories...
๐ Scanned 6 repos:
commit-checker โ โ
 2 today | ๐งฎ 41 total | ๐ Today
blog-api โ โ 0 today | ๐งฎ 89 total | ๐ Jul 17
my-website โ โ
 1 today | ๐งฎ 156 total | ๐ Today$ commit-checker --build-profile
๐ง Building your smart coding profile...
   ๐ Analyzing commit history patterns...
   ๐ Detecting project tech stacks...
   ๐ Scanning project structures...
โ
 Profile built successfully!
   ๐ Analyzed 6 repositories
   ๐ก Smart suggestions now enabled
$ commit-checker --coach "fixed stuff"
๐ Analyzing: "fixed stuff"
๐ก Suggestions:
  ๐ก Casual style detectedโadd detail? E.g., fixed stuff โ fixed login crash
  ๐ก 'stuff' is vagueโwhat specifically? E.g., 'fixed login stuff' โ 'fixed login validation'
$ commit-checker --coach "fix auth bug" --feedback good
๐ Analyzing: "fix auth bug"
๐ก Suggestions:
  ๐ก Your 'blog-api' uses 'feat:'โtry 'feat: fix auth bug'?
๐ Thanks! Tuned your preferences.
$ commit-checker --insights
๐ง  Personal Coding Insights
==================================================
๐ Overall Style:
   โข Average commit length: 7.5 words
   โข Preferred mood: Imperative
   โข Uses emojis: No
๐ Repository Analysis (6 repos):
   ๐ง Tech Stack Distribution:
     โข Python: 4 repos (67%)
     โข Javascript: 2 repos (33%)
     โข Cli: 1 repos (17%)
   ๐ Commit Style Breakdown:
     โข Imperative: 4 repos (67%)
     โข Lowercase: 2 repos (33%)
๐ Profile last updated: 2025-09-18 12:10
$ commit-checker til "Learned async patterns"
๐ก TIL Tag Suggestions:
  ๐ก Add --tag python? (detected Python repo)
  ๐ก Add --tag async? (detected 'async' context)
โ
 TIL entry added
$ commit-checker --coach "refactor everything"
๐ Analyzing: "refactor everything"
๐ก Suggestions:
  ๐ก Large commit (150+ lines, 12 files)โsplit into smaller commits?
  ๐ก Casual style detectedโadd detail? E.g., refactor everything โ refactored user auth module- ๐ง Fixed Standalone Profile Commands - --build-profile,--insights,--coachnow work in standalone mode
- ๐ฑ Added --versionFlag - Show version information and project details
- ๐ก๏ธ Enhanced Standalone Compatibility - Profile functions now work for curl/bash installations
- ๐ Fixed Update System - Resolved infinite update loops in standalone mode
- ๐ฆ Improved Command Routing - All Smart Profile System commands now properly execute
- ๐ Critical Bug Fixes - Fixed sys import error causing command failures
- โก Enhanced Stability - All commands now exit cleanly without errors
- ๐ก๏ธ Improved Install Script - Better error handling during installation
- ๐ง Refined Coaching - More accurate freeform style detection
- ๐ Performance Optimizations - Faster profile building and analysis
- ๐ง Adaptive Coaching - Suggests clarity for freeform styles (e.g., "fixed stuff โ fixed login crash")
- ๐ Expanded Tech Detection - Added PHP, Swift, Kotlin, Elixir, Scala, Haskell, TypeScript
- ๐ก New Suggestions - Commit size nudges, TIL tag recommendations
- ๐ --feedback good/bad - Tune coaching preferences
- ๐ง Stack-aware Suggestions - Django migrations, npm installs, cargo checks, etc.
- ๐ Personal Coding Insights - Analyze your habits, tech stack distribution, and style evolution
- ๐ Project Structure Analysis - Suggests tests, documentation, and maintenance tasks
- ๐ต Sound Notifications - Audio feedback for completions and suggestions
- ๐ง New Commands: --build-profile,--coach,--insights,--no-profile,--feedback
- ๐ Commit Message Analysis - New --suggestcommand analyzes and improves commit messages
- ๐ Quick Dashboard - New --dashboardcommand for instant daily overview
- โฐ Time Analytics - New --time-statscommand shows coding patterns by time of day
- ๐ Streak Milestones - Customizable celebrations for 5, 10, 30, 100+ day streaks
- ๐ Custom TIL Templates - Create personalized templates with --add-template
- โ๏ธ XP System Rebalanced - Fixed inflation with logarithmic scaling and level-based caps
- ๐ New Achievements - Secret achievements, polyglot badges, and midnight coder rewards
- ๐จ Complete Uninstallation - Fixed --uninstallleaving shell startup commands, now removes ALL traces
- ๐ก๏ธ Bulletproof Wizard - Enhanced --initvalidation prevents invalid input choices with clear error messages
- ๐ Improved Detection - Fixed duplicate repository paths and enhanced counting accuracy in setup
- โก Standalone Completeness - Added ALL missing commands (--achievements,--xp,--heatmap, etc.) to curl version
- โจ Better UX - Instant theme feedback, robust input validation, and enhanced error handling
$ commit-checker --dashboard
๐ Today's Dashboard
==============================
๐ฉ Commits Today: 3
๐ฅ Streak: 12 days
โก Level 5: [โโโโโโโโโโโโโโโ] 650/700 XP
๐ Top Repo: commit-checker (2 commits)
$ commit-checker --suggest
๐ Latest commit in my-website: "updated code"
๐ก Suggestions:
  โข Consider starting with an action verb (Add/Fix/Update/etc.)
  โข Message is too vague. Be more specific about what changed
$ commit-checker --time-stats
โฐ Commit Time Stats (Last 30 Days)
========================================
Morning (6 AMโ12 PM):   [โโโโโโโโโโโโโโโโโโโโ] 15 commits
Afternoon (12 PMโ6 PM): [โโโโโโโโโโโโโโโโโโโโ] 32 commits  
Evening (6 PMโ12 AM):   [โโโโโโโโโโโโโโโโโโโโ] 21 commits
Night (12 AMโ6 AM):     [โโโโโโโโโโโโโโโโโโโโ] 3 commits
$ commit-checker --add-template learning "What I learned: {description}\nWhy it matters: {impact}"
Custom template 'learning' added successfully- ๐ฎ Complete Gamification - Achievement system with ASCII art, XP levels, streak tracking
- ๐ Advanced Analytics - ASCII heatmaps, language breakdown, SVG export, mood system
- ๐ TIL Vault System - Templates, fuzzy search, auto-generation from diffs, individual files
- โก Offline-First Architecture - Zero external dependencies, pure git-powered analytics
- ๐ง Developer-Friendly Hooks - Non-blocking git hooks for seamless integration
- ๐ ๏ธ 15+ New Commands - Comprehensive CLI with gamification, analytics, and vault features
- ๐งโโ๏ธ Interactive Setup Wizard - Complete guided configuration with --init
- ๐ ASCII Statistics - Visual commit trends and repository analytics
- ๐ Enhanced TIL System - Tags, filtering, and export functionality
- ๐ System Diagnostics - Comprehensive health checks and troubleshooting
- ๐ง Critical Bug Fixes - Fixed update loops and PEP 668 uninstall issues
- ๐ New TIL Command - Log daily learnings with commit-checker til "message"
- ๐ Local Storage - Entries saved to ~/.commit-checker/til.mdwith smart date organization
- ๐๏ธ Editor Integration - --edit-tilopens your TIL log in default editor
- ๐ View & Reset - --view-tiland--reset-tilfor easy management
- ๐ง Customizable - Configure TIL path via config.json
- ๐ Intelligent Update Scheduling - Install updates now or on next terminal restart
- ๐ Release Notes Preview - See what's new before updating
- ๐ง Robust Update Methods - Multiple fallback installation approaches
- ๐ Pending Update Management - Automatic installation of scheduled updates
- ๐ Repository scanning with --scanflag
- ๐ Complete repo summaries with commit statistics
- ๐ฅ Most active repo detection (daily, weekly, monthly)
- ๐จ Configurable output modes (emoji or plain text)
- ๐๏ธ Enhanced uninstall with --forceoption
- โ๏ธ Persistent configuration with repo folder settings
- ๐ Smart auto-detection of git repositories
- ๐ Enhanced cross-platform support
- ๐ Multiple path monitoring
- ๐ Standalone bash version (no pip issues!)
- ๐ ๏ธ Improved setup experience
- โ Basic GitHub and local commit tracking
- ๐๏ธ CLI interface with multiple flags
- ๐ Auto-update functionality