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 settingscommit-checker --diagnose- Run system diagnostics
๐ง Smart Profile System (v0.7.0):
commit-checker --build-profile- Build/rebuild your personalized coding profilecommit-checker --coach "fix user auth"- Get commit message coaching suggestionscommit-checker --feedback good/bad- Give feedback on coaching suggestions to tune preferencescommit-checker --insights- Show personalized coding insights and habitscommit-checker --no-profile- Skip profile-based suggestions for this run
Core functionality:
commit-checker- Check today's commits with gamificationcommit-checker --scan- Scan repo folder for all git repositoriescommit-checker --repos-summary- Show full summary of all reposcommit-checker --most-active- Show most active repository todaycommit-checker --most-active --week- Show most active repo this weekcommit-checker --most-active --month- Show most active repo this monthcommit-checker --stats- Show ASCII commit trend charts (30 days)
๐ฎ Gamification & Progress:
commit-checker --achievements- Display achievement gallery with ASCII artcommit-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 heatmapcommit-checker --heatmap-export svg- Export heatmap to SVG filecommit-checker --stats-lang- Programming language breakdown with chartscommit-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 logcommit-checker til "Fixed bug" --template bugfix- Use template for vault entrycommit-checker --list-templates- Show available TIL templatescommit-checker --add-template NAME "STRUCTURE"- Create custom TIL templatescommit-checker --til-vault- Show TIL vault summary with statscommit-checker --search-til "async"- Fuzzy search TIL entriescommit-checker --til-from-diff- Generate TIL from latest commit changescommit-checker --view-til- View your complete TIL logcommit-checker --view-til --filter-tag python- View TIL entries by tagcommit-checker --edit-til- Edit TIL log in your default editorcommit-checker --export md- Export TIL to Markdown filecommit-checker --export json- Export TIL to JSON filecommit-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 updatescommit-checker --uninstall- Remove completely (with PEP 668 support)commit-checker --uninstall --force- Remove without confirmationcommit-checker --support- Show support infocommit-checker --silent- Minimal outputcommit-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