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 ๐ง โ๏ธ
- โ Optimized Git Operations - Faster repository scanning and commit analysis
- โ Reduced Memory Footprint - More efficient resource usage
- โ Improved Error Handling - More robust and user-friendly error messages
- โ Enhanced Cross-Platform Compatibility - Better support for various shell environments
- โ Refactored Core Logic - Cleaner, more maintainable codebase
- โ 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)
- โ
AI-powered commits (
--suggest) - Optional ML-based suggestions (DialoGPT, DistilBERT) - โ GitHub streak tracker - Never miss a day with automated checks
- โ Wisdom Drop Integration - Daily coding wisdom from AmariahAK/wisdom-drop
- โ Status Bar Widget - Shows streak, daily commits, and level at a glance
- โ Interactive Dashboard - Beautiful webview with XP progress and achievements
- โ TIL Integration - Add and search TIL entries from the editor
- โ Achievements Gallery - View unlocked badges within VS Code
- โ Local & Secure - Uses existing CLI installation, no separate login
- โ Auto-refresh - Configurable stats updates (default: 5 minutes)
- โ Category Display - Shows wisdom category (Developer, Samurai, Faith, etc.)
- โ Date Information - Displays the specific date of each quote
- โ Daily Refresh - Automatically updates quotes daily
- โ Smart Caching - Efficient fetching with commit-based invalidation
- โ
Example:
๐ก [Samurai Discipline / Modern Focus] Wisdom of the day (November 21 2025): "A samurai does not wait for the perfect wind..." โ Inspired by the Way of the Samurai - โ 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 complex setup - works with any Python installation
- โ 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.8.5 Update: Advanced AI Integration with 4 model options (TensorFlow, Ollama, Together AI, Heuristic). All installation methods updated.
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 # Git clone 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