Repository navigation
commit-checker v0.5.0
🎉 commit-checker v0.5.0 - Interactive Wizards & Enhanced Analytics
The biggest update yet! This release introduces powerful new interactive features, comprehensive system diagnostics, enhanced TIL logging, and critical bug fixes that make commit-checker more reliable and user-friendly than ever.
🔧 Critical Bug Fixes
✅ Fixed Infinite Update Loop
Issue: Users experienced endless update prompts even after successful updates
Solution: Implemented intelligent version detection with local caching and 24-hour check intervals
Impact: No more annoying repeated update notifications
✅ Fixed PEP 668 Uninstall Issues
Issue: --uninstall failed on macOS and systems with externally managed Python environments
Solution: Smart detection of installation method (pip, pipx, standalone) with appropriate fallback strategies
Impact: Clean uninstalls work across all Python environments
🧙♂️ Interactive Setup Wizard
New Command: commit-checker --init
Transform your first-time setup experience with our guided configuration wizard:
🔍 Smart Path Detection: Automatically discovers your development folders
🎨 Theme Selection: Choose from 5 unique themes (tech, kawaii, anime, horror, default)
📝 Commit Rules Setup: Configure custom regex patterns for commit message validation
🔗 Pre-commit Hooks: Optional Git hook installation for automated validation
⚙️ Complete Configuration: GitHub integration, TIL settings, and output preferences
Perfect for new users and those wanting to reconfigure their setup!
📊 ASCII Statistics & Visual Analytics
New Command: commit-checker --stats
Get beautiful visual insights into your coding activity:
📊 Commit Statistics (Last 30 Days)
📁 my-awesome-project
Total commits: 42
Trend: ▁▂▃▄▅▆▇█▇▆▅▄▃▂▁▂▃▄▅▆▇█▇▅▃▂▁▂▃▄▅
Recent: 2025-07-23: 3, 2025-07-24: 5, 2025-07-25: 8
📈 Visual Trends: Unicode bar charts showing 30-day commit patterns
📊 Multi-Repository: Analyze all your local repositories at once
🎯 Recent Activity: Quick summary of your last week's activity
🔍 Repository Health: Identify your most and least active projects
📚 Enhanced TIL (Today I Learned) System
Supercharged learning documentation with advanced features:
🏷️ Tag Support
commit-checker til "Learned async/await patterns" --tag python
commit-checker til "CSS Grid layout tricks" --tag css
🔍 Smart Filtering
commit-checker --view-til --filter-tag python
Shows only Python-related learnings
📤 Export Functionality
commit-checker --export json # Structured data export
commit-checker --export md # Clean Markdown export
📈 Enhanced Analytics
Tag Statistics: Track learning categories
Entry Counting: Monitor your learning progress
Date Organization: Smart chronological grouping
🔍 System Diagnostics & Health Checks
New Command: commit-checker --diagnose
Comprehensive system analysis for troubleshooting:
🔍 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
📚 Dependencies: ✅ All available
🐍 Environment: Virtual environment
✅ Diagnostics complete!
🔧 Installation Detection: Identifies pip, pipx, or standalone installation
📋 Dependency Check: Verifies all required packages
⚙️ Config Validation: Ensures configuration integrity
🐍 Environment Analysis: Python version and virtual environment detection
🛠️ Technical Improvements
Performance & Reliability
⚡ Lazy Loading: Faster startup times with on-demand module loading
🔄 Enhanced Error Handling: Better fallback mechanisms for network issues
💾 Smart Caching: Intelligent version and update management
🔧 Config Migration: Automatic upgrade of old configuration formats
Cross-Platform Enhancements
🖥️ Universal Compatibility: Improved support for macOS, Linux, and Windows
📦 Installation Methods: Robust handling of pip, pipx, and standalone installations
🎯 Path Detection: Enhanced development folder discovery across platforms
📋 Complete Command Reference
Setup & Configuration
commit-checker --init - NEW Interactive setup wizard
commit-checker --setup - Quick reconfiguration
commit-checker --diagnose - NEW System health check
Analytics & Statistics
commit-checker --stats - NEW ASCII commit trend charts
commit-checker --scan - Repository scanning
commit-checker --most-active - Find most active repository
Enhanced TIL Commands
commit-checker til "message" --tag python - NEW Tagged entries
commit-checker --view-til --filter-tag python - NEW Filter by tag
commit-checker --export md - NEW Export to Markdown
commit-checker --export json - NEW Export to JSON
🚀 Installation & Upgrade
New Installation
Recommended: Safe installation method
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash
Or: Traditional pip method
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/install.sh | bash
Upgrading from Previous Versions
commit-checker --update # Interactive update with options
Your existing configuration and TIL entries will be automatically migrated and preserved.
💡 What's Next
I'm continuously improving commit-checker! Coming in future releases:
🎨 Interactive TUI mode with rich terminal interfaces
🔗 GitHub sync mode for advanced repository analysis
🔌 Plugin system for custom extensions
📝 Advanced commit message validation rules
🤖 AI-powered commit insights
📞 Support & Feedback
🐛 Found a bug? Open an issue
💡 Feature request? Start a discussion
💖 Love the tool? Support development
🎯 Breaking Changes
None! This release maintains full backward compatibility. All existing commands and configurations continue to work as expected.
Due to changes in Python package management and multiple installation methods, some users may experience conflicts when upgrading. Follow this guide for a smooth installation.
🆘 Quick Fix for Installation Issues
If you're having ANY issues with installation or old versions not updating, use this one-command fix:
🧹 Nuclear cleanup + fresh install (works for all cases)
rm -f ~/.local/bin/commit-checker &&
rm -rf ~/.commit-checker-standalone &&
python3 -m pip uninstall commit-checker -y --break-system-packages 2>/dev/null || true &&
hash -r &&
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash
After running this, verify it worked:
commit-checker --help
Should show new commands: --init, --stats, --diagnose, etc.
🔍 Detailed Troubleshooting by Scenario
Scenario 1: "externally-managed-environment" Error
error: externally-managed-environment
× This environment is externally managed
Solution:
Use --break-system-packages flag
python3 -m pip uninstall commit-checker -y --break-system-packages
Then install fresh
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash
Scenario 2: Multiple Installations Conflict
Symptoms: commit-checker --help shows old commands or --version doesn't work
Solution:
Check what you have installed
which commit-checker
python3 -m pip list | grep commit-checker
Remove all installations
rm -f ~/.local/bin/commit-checker # Standalone
rm -rf ~/.commit-checker-standalone # Standalone cache
python3 -m pip uninstall commit-checker -y --break-system-packages # Pip
brew uninstall commit-checker 2>/dev/null || true # Homebrew (if exists)
Clear shell cache and reinstall
hash -r
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash
Scenario 3: Old Standalone Script Running
Symptoms: Seeing "📥 Downloading..." messages or missing new features
Solution:
Remove old standalone files
rm -f ~/.local/bin/commit-checker
rm -rf ~/.commit-checker-standalone
Install fresh
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash
Scenario 4: Homebrew Installation Issues
Symptoms: Binary exists at /opt/homebrew/bin/commit-checker
Solution:
Try Homebrew uninstall first
brew uninstall commit-checker 2>/dev/null || true
If that fails, force remove
sudo rm -f /opt/homebrew/bin/commit-checker
Install fresh
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash
✅ Verify Your Installation
After installation, these commands should work:
Basic check
commit-checker --help
Should show: --init, --stats, --diagnose, --export, --filter-tag, etc.
Version check (new in v0.5.0)
commit-checker --diagnose
Should show system information and v0.5.0
Test new features
commit-checker --init # Interactive setup wizard
commit-checker --stats # ASCII commit charts (if configured)
🚀 Fresh Installation (New Users)
Recommended Method (Always Use This)
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bash
Alternative Methods
Method 2: Direct download and execute
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: Traditional pip (if you prefer)
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/install.sh | bash
🔧 Configuration Preservation
Your data is safe! During cleanup and reinstall:
✅ TIL entries are preserved (~/.commit-checker/til.md)
✅ Configuration is automatically migrated
✅ GitHub settings are maintained
🆘 Still Having Problems?
Step 1: Gather System Info
Run this and share the output in your issue
echo "=== System Info ==="
python3 --version
which python3
pip --version 2>/dev/null || echo "pip not available"
pipx --version 2>/dev/null || echo "pipx not available"
echo "=== Existing Installations ==="
which commit-checker || echo "No commit-checker in PATH"
python3 -m pip list | grep commit-checker || echo "Not installed via pip"
ls -la ~/.local/bin/commit-checker 2>/dev/null || echo "No standalone installation"
echo "=== Environment ==="
echo $PATH | tr ':' '\n' | grep -E "(local|homebrew)" || echo "No local/homebrew in PATH"
Step 2: Try pipx Method
Install pipx if you don't have it
brew install pipx || python3 -m pip install --user pipx
Install commit-checker via pipx
pipx install git+https://github.com/AmariahAK/commit-checker.git
Step 3: Open an Issue
If you're still stuck, open an issue with:
Your system info from Step 1
The exact error messages you're seeing
Your operating system (macOS version, Linux distro, etc.)
🎯 Why These Issues Happen
PEP 668: Python 3.12+ has stricter package management
Multiple Installation Methods: pip, pipx, Homebrew, and standalone can conflict
Version Caching: Old installations can interfere with updates
PATH Priority: Shell can find old binaries before new ones
v0.5.0 includes enhanced installation detection to prevent these issues in the future!