Skip to content

AmariahAK/commit-checker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

67 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŸข commit-checker

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 ๐Ÿง โš™๏ธ


โœจ Features

๐Ÿง  NEW: Smart Profile System (v0.7.0)

  • โœ… 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

๐ŸŽฎ Gamification & Developer Progress (v0.6.0)

  • โœ… 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

๐Ÿ“Š NEW: Advanced Analytics & Visualizations (v0.6.0)

  • โœ… 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

๐Ÿ“š NEW: TIL Vault System (v0.6.0)

  • โœ… 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

๐Ÿ”ง Core Functionality

  • โœ… 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 & Configuration

  • โœ… 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

๐Ÿ“Š Enhanced Statistics & Repository Analysis

  • โœ… 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 & Health

  • โœ… System Diagnostics (--diagnose) for troubleshooting
  • โœ… Installation Method Detection (pip, pipx, standalone)
  • โœ… Dependency Verification and environment analysis
  • โœ… Configuration Validation with automatic migration

๐Ÿ› ๏ธ Installation & Updates

  • โœ… 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

๐Ÿš€ Quick Install (Recommended)

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.

Method 1: Safe Installation (Recommended - avoids encoding issues)

curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash

Method 2: Manual Download (Most reliable)

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

Method 3: Direct Pipe (May have encoding issues on some systems)

curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash

Method 4: Run Without Installation

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

Method 5: Traditional pip Install

curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/install.sh | bash

๐Ÿ”ง Smart Setup Experience

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:

๐ŸŽ›๏ธ Usage

Basic usage:

commit-checker

All 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

๐ŸŒ Cross-Platform Path Detection

macOS: ~/Documents/GitHub, ~/Developer, ~/Desktop/GitHub
Linux: ~/workspace, ~/devel, /var/www
Windows: ~/source, C:\Projects, C:\xampp\htdocs


๐Ÿ—๏ธ Project Structure

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

โ˜• Support

If this tool helps you stay consistent, focused, or productive โ€” consider supporting development!

Buy Me A Coffee

Or visit: https://buymeacoffee.com/amariahak


๐Ÿ‘จ๐Ÿฝโ€๐Ÿ’ป Built By

Amariah Kamau
๐Ÿ“‚ GitHub: @AmariahAK
๐ŸŒ Portfolio: https://portfolio-pied-five-61.vercel.app


๐Ÿ“„ License

Licensed under the MIT License.


๐Ÿ“ TIL (Today I Learned) Feature

Track your daily learnings with commit-checker's built-in TIL functionality:

Basic Usage

# 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

Example TIL Log

# 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

Advanced Options

# Add entry without date grouping
commit-checker til "Quick tip" --no-date

# Reset all entries (with confirmation)
commit-checker --reset-til

TIL Storage: Entries are saved to ~/.commit-checker/til.md and persist between sessions unless manually deleted.


๐Ÿ”ฅ New Features in Action

๐ŸŽฎ Gamification System

$ 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

๐Ÿ“Š Advanced Analytics

$ 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

๐Ÿ“š TIL Vault System

$ 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

Interactive Setup Wizard

$ 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!

ASCII Commit Statistics

$ 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

Enhanced TIL with Tags

$ 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

System Diagnostics

$ 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!

Repository Scanning

$ 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

Smart Profile System (v0.7.0)

$ 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

๐ŸŽ‰ Recent Updates

v0.7.2 - Standalone Script Fixes (Latest)

  • ๐Ÿ”ง Fixed Standalone Profile Commands - --build-profile, --insights, --coach now work in standalone mode
  • ๐Ÿ“ฑ Added --version Flag - 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

v0.7.1 - Smart Profile System

  • ๐Ÿ› 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

v0.7.0 - Smart Profile System

  • ๐Ÿง  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

v0.6.2 - Enhanced Feedback & Advanced Analytics

  • ๐Ÿ” Commit Message Analysis - New --suggest command analyzes and improves commit messages
  • ๐Ÿ“Š Quick Dashboard - New --dashboard command for instant daily overview
  • โฐ Time Analytics - New --time-stats command 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

v0.6.1 - Critical Fixes & Enhanced Reliability

  • ๐Ÿšจ Complete Uninstallation - Fixed --uninstall leaving shell startup commands, now removes ALL traces
  • ๐Ÿ›ก๏ธ Bulletproof Wizard - Enhanced --init validation 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

New v0.6.2 Features in Action

$ 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

v0.6.0 - Offline Gamified Power Mode

  • ๐ŸŽฎ 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

v0.5.0 - Interactive Wizards & Enhanced Analytics

  • ๐Ÿง™โ€โ™‚๏ธ 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

v0.4.3 - TIL (Today I Learned) Feature

  • ๐Ÿ“ New TIL Command - Log daily learnings with commit-checker til "message"
  • ๐Ÿ“ Local Storage - Entries saved to ~/.commit-checker/til.md with smart date organization
  • ๐Ÿ–Š๏ธ Editor Integration - --edit-til opens your TIL log in default editor
  • ๐Ÿ‘€ View & Reset - --view-til and --reset-til for easy management
  • ๐Ÿ”ง Customizable - Configure TIL path via config.json

v0.4.2 - Enhanced Update System

  • ๐Ÿ”„ 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

v0.4.1 - Advanced Repository Analytics

  • ๐Ÿ” Repository scanning with --scan flag
  • ๐Ÿ“Š Complete repo summaries with commit statistics
  • ๐Ÿ”ฅ Most active repo detection (daily, weekly, monthly)
  • ๐ŸŽจ Configurable output modes (emoji or plain text)
  • ๐Ÿ—‘๏ธ Enhanced uninstall with --force option
  • โš™๏ธ Persistent configuration with repo folder settings

v0.2.0 - Smart Detection & Standalone Support

  • ๐Ÿ” Smart auto-detection of git repositories
  • ๐ŸŒ Enhanced cross-platform support
  • ๐Ÿ“ Multiple path monitoring
  • ๐Ÿš€ Standalone bash version (no pip issues!)
  • ๐Ÿ› ๏ธ Improved setup experience

v0.1.0 - Initial Release

  • โœ… Basic GitHub and local commit tracking
  • ๐ŸŽ›๏ธ CLI interface with multiple flags
  • ๐Ÿ”„ Auto-update functionality