Skip to content

AmariahAK/commit-checker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

83 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: Performance & Stability (v0.8.0)

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

๐Ÿง  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)
  • โœ… 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

๐Ÿ“ฑ NEW: VS Code Extension (v0.8.0)

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

๐Ÿ’ก Enhanced Wisdom Drop (v0.8.0)

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

๐Ÿ“Š 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 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

๐Ÿš€ Quick Install (Recommended)

v0.8.5 Update: Advanced AI Integration with 4 model options (TensorFlow, Ollama, Together AI, Heuristic). All installation methods updated.

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: Git Clone 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 # 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 

โ˜• 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

About

Stay consistent. Stay accountable. Stay committed

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •