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 ๐ง โ๏ธ
--coach) - Suggests improvements based on your style--insights) - Analyze your coding habits and trends--suggest) - Optional ML-based suggestions (DialoGPT, DistilBERT)๐ก [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--init) with guided configuration--stats) showing 30-day trends--scan) with commit analysis--diagnose) for troubleshootingundefinedv0.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 | bash
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh -o /tmp/install.sh
chmod +x /tmp/install.sh
/tmp/install.sh
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
curl -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.sh
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/install.sh | bash
On 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:
undefinedBasic usage:undefined
commit-checker
undefinedAll available commands:undefined
undefinedSetup & Configuration:undefined
commit-checker --init - Interactive setup wizard (recommended for first-time users)commit-checker --setup - Quick reconfigure settingscommit-checker --diagnose - Run system diagnosticsundefined๐ง Smart Profile System (v0.7.0):undefined
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 runundefinedCore functionality:undefined
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)undefined๐ฎ Gamification & Progress:undefined
commit-checker --achievements - Display achievement gallery with ASCII artcommit-checker --xp - Show current XP, level, and progress to next levelundefined๐ Analytics & Visualizations:undefined
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 improvementsundefined๐ Enhanced TIL (Today I Learned) Vault System:undefined
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 headerundefinedSystem commands:undefined
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/colorsundefinedmacOS: ~/Documents/GitHub, ~/Developer, ~/Desktop/GitHub
undefinedLinux: ~/workspace, ~/devel, /var/www
undefinedWindows: ~/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
undefinedAmariah Kamauundefined
๐ 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-til
undefinedTIL 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
--build-profile, --insights, --coach now work in standalone mode--version Flag - Show version information and project details--build-profile, --coach, --insights, --no-profile, --feedback--suggest command analyzes and improves commit messages--dashboard command for instant daily overview--time-stats command shows coding patterns by time of day--add-template--uninstall leaving shell startup commands, now removes ALL traces--init validation prevents invalid input choices with clear error messages--achievements, --xp, --heatmap, etc.) to curl version$ 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
--initcommit-checker til "message"~/.commit-checker/til.md with smart date organization--edit-til opens your TIL log in default editor--view-til and --reset-til for easy management--scan flag--force optionWe use cookies
We use cookies to analyze traffic and improve your experience. You can accept or reject analytics cookies.