Releases: AmariahAK/commit-checker
🚀 Release Notes - v0.7.8
Critical Bug Fixes & Quote Enhancement
🐛 Critical Fixes
Fixed GitHub API KeyError Crash
Resolved crash when GitHub event payload is missing the commits field
Added safe fallback to prevent application errors
Improved error resilience for GitHub event parsing
Before:
KeyError: 'commits'
After:
✅ Gracefully handles all GitHub event types
✨ Enhancements
Improved Wisdom Drop Quote Format
Quote category now prominently displayed at the beginning
Better visual hierarchy and readability
Before:
💡 Wisdom Drop: "Quote text" — Author, Category
After:
💡 [Category] Wisdom of the day: "Quote text" — Author
📦 Installation
Standalone (Recommended):
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
🔧 What's Changed
GitHub API now safely handles missing commit data
Quote format updated to highlight category first
More robust error handling for external API calls
🔗 Links
Repository: https://github.com/AmariahAK/commit-checker
Wisdom Drop: https://github.com/AmariahAK/wisdom-drop
Support: https://buymeacoffee.com/amariahak
💀 Release Notes - v0.7.7
🚀 Smart Quote Refresh & Bug Fixes
✨ New Features
🎯 Intelligent Quote Caching
- Wisdom Drop now tracks the latest commit SHA from the wisdom-drop repository
- Automatically detects new quotes when the wisdom-drop repo is updated
- No more waiting 24 hours - new quotes appear instantly after you push them!
- Works seamlessly across different time zones
🔄 Manual Quote Refresh
commit-checker --refresh-quoteForce refresh the Wisdom Drop quote anytime you want
🐛 Bug Fixes
Fixed Standalone Script Quote Display
- Resolved
script_dirscope issue that prevented quotes from showing in standalone installation - Wisdom Drop quotes now display correctly for all installation methods
Suppressed SSL Warnings
- Eliminated annoying urllib3 OpenSSL compatibility warnings on macOS LibreSSL systems
- Cleaner terminal output without breaking functionality
🔧 Technical Improvements
- Cache validation now checks both commit SHA and timestamp (24hr fallback)
- Wisdom Drop integration more reliable with GitHub API tracking
- Bootstrap module enhanced with warning filters
📦 Installation
Standalone (Recommended):
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash🔗 Links
- Repository: https://github.com/AmariahAK/commit-checker
- Wisdom Drop: https://github.com/AmariahAK/wisdom-drop
- Support: https://buymeacoffee.com/amariahak
Full Changelog: v0.7.6...v0.7.7
🥳 Standalone Script Complete Fix
🔧 commit-checker v0.7.6 - Standalone Script Complete Fix
Standalone users now get ALL features including Wisdom Drop quotes!
🚨 Critical Fixes for Standalone Installations
✅ Fixed: Wisdom Drop Not Showing in Standalone
- Issue: Standalone script (curl install) wasn't displaying daily Wisdom Drop quotes
- Root Cause: Embedded Python code in standalone script was missing v0.7.5+ features
- Fix: Completely rebuilt standalone script with full Wisdom Drop integration
- Result: Standalone users now see motivational quotes on every run! 🎉
✅ Fixed: Misleading "No Public Commits" Message
- Issue: Showed
😢 No public commits found todayeven when local commits existed - Fix: Reordered display - local commits shown FIRST, then GitHub
- New Message:
ℹ️ No commits pushed to GitHub yet (local commits not yet pushed) - Better UX: See your work immediately, clear messaging about push status
✅ Fixed: Install Script Issues
- Issue: Some users experienced "cho: command not found" errors
- Fix: Updated bootstrap to include
markdowndependency - Result: Smoother installation experience
🎯 What's Now Working
Standalone Feature Parity
Standalone installations (curl/bash) now have 100% feature parity with pip installations:
# All these work in standalone now!
commit-checker # Shows Wisdom Drop quote ✅
commit-checker --suggest "draft" # AI context suggestions ✅
commit-checker --refresh-quote # Manual quote refresh ✅
commit-checker --download-models # Optional AI models ✅
commit-checker --repair # Asset repair ✅Expected Output (v0.7.6)
commit-checker
🗂️ Scanning 1 local path(s):
📁 /Users/you/Documents/GitHub
🟩 Local Commits:
📁 Repository: my-project
📍 Path: /Users/you/Documents/GitHub/my-project
📊 2 commit(s) today:
abc1234 feat: add new feature
def5678 fix: resolve bug
🌐 GitHub: @YourUsername
ℹ️ No commits pushed to GitHub yet (local commits not yet pushed)
⚡ 2 commits today | +25 XP | 10🔥 streak | 🚀 Coding machine!
💫 +25 XP earned today!
🔥 Current streak: 10 days
💡 Wisdom Drop: "Don't count the days, make the days count." — Muhammad Ali, Wisdom📦 Installation/Update
Fresh Install
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bashUpdate from v0.7.5/v0.7.5.1
# Manual update (recommended)
rm -rf ~/.commit-checker-standalone ~/.local/bin/commit-checker
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
# Or use auto-update
commit-checker --update🛠️ Technical Changes
Files Modified:
scripts/commit-checker-standalone.sh- Rebuilt embedded Python code with v0.7.6 featurescommit_checker/cli.py- Improved Wisdom Drop error handlingcommit_checker/updater.py- Version bump to 0.7.6setup.py- Version bump to 0.7.6LICENSE.md- Updated to permissive non-commercial license
What Changed in Standalone Script:
- Added Wisdom Drop integration to embedded code
- Reordered commit display (local → GitHub)
- Updated version display to v0.7.6
- Better error handling for quote retrieval
- Downloads wisdom.py, context.py, ai_handler.py modules
📝 License Update
New License: Permissive Non-Commercial License
- ✅ Free for personal use - No restrictions on personal, non-commercial use
- ✅ Open to contributions - Pull requests welcome
- ✅ Attribution required - Forks must credit Amariah Kamau
- ❌ Commercial use requires permission - Contact for commercial licensing
See LICENSE.md for full terms.
🐛 Known Issues
None! If you find any, please open an issue.
📊 v0.7.6 Statistics
- 4 files updated for standalone parity
- 12+ lines added to embedded standalone code
- 100% feature parity between pip and standalone
- Wisdom Drop now works everywhere!
🎯 Full v0.7.x Feature Set
This release includes all features from v0.7.5/v0.7.5.1:
- 💡 Wisdom Drop Integration - Daily motivational quotes on every run
- 🤖 AI Commit Context - Smart suggestions from git diff analysis
- 🧠 Enhanced Heuristics - Vague word detection, typo checking, smart verb suggestions
- 🔧 Fixed --update loop - No more infinite prompts
- 📦 GitHub API caching - 1-hour cache for rate limit resilience
- 🎯 Local commit priority - Detects commits using author email filtering
- 📝 Better messaging - Clear distinction between local and pushed commits
🙏 About the Creator
Amariah Kamau - Solo Creator & Maintainer
Projects:
- 🟢 commit-checker - Keep your GitHub streak alive
- 💡 Wisdom Drop - Daily motivational quotes
Links:
- GitHub: @AmariahAK
- Portfolio: https://portfolio-pied-five-61.vercel.app
☕ Support Development
If commit-checker helps you stay consistent and motivated:
📋 Changelog
Full Changelog: v0.7.2...v0.7.6
v0.7.6 Changes
- ✅ Fixed Wisdom Drop not showing in standalone installations
- ✅ Rebuilt standalone script with full feature parity
- ✅ Fixed commit display order (local first, GitHub second)
- ✅ Improved "No public commits" messaging
- ✅ Updated license to permissive non-commercial terms
v0.7.5.1 Changes (included)
- ✅ Fixed Wisdom Drop quote double-quote display
- ✅ Added --debug flag for troubleshooting
- ✅ Improved error handling
v0.7.5 Changes (included)
- ✅ AI commit context extraction
- ✅ Wisdom Drop integration
- ✅ Fixed --update infinite loop
- ✅ Fixed "No Public Commits Found" bug
- ✅ Optional HuggingFace model support
🚀 Quick Start
# Install v0.7.6
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
# First time setup
commit-checker --init
# Daily check with Wisdom Drop
commit-checker
# AI-powered suggestions
commit-checker --suggest "fix bug"Happy coding! Keep that streak alive! 🔥
🤖 AI Commit Mentor
🚀 commit-checker v0.7.5 - AI Commit Mentor
AI-powered commit context, daily inspiration from Wisdom Drop, and critical bug fixes
🎯 What's New
💡 Wisdom Drop Integration
Every commit check now includes a daily motivational quote from the Wisdom Drop repository - helping you stay inspired while maintaining your coding streak!
commit-checker
# ... your commit stats ...
💡 Wisdom Drop: "The only way to do great work is to love what you do." — Steve Jobs, MotivationFeatures:
- 📅 Automatically displays the latest quote (up to current date)
- 💾 24-hour caching for offline resilience
- 🎨 Respects your emoji/plain output preferences
- 🔄 Manual refresh with
--refresh-quote - ⚙️ Toggle via config:
inspire: true/false
🤖 AI Commit Context System
Smart commit suggestions now understand what you actually changed:
commit-checker --suggest "fix bug"
🧠 Context summary:
📁 3 file(s) changed
+42 additions, -15 deletions
Files:
- auth.py
- login.tsx
- README.md
🔖 Conventional type suggestion: fix
✨ Suggested commit message:
💡 'fix bug' is vague - specify what changed (e.g., 'fix auth.py validation')
💡 Conventional format: fix(auth): fix bug
💡 Start with action verb (e.g., 'fix: fix bug')Powered by:
- Git diff analysis (staged files, additions/deletions)
- Conventional commit type detection (feat/fix/docs/test/chore)
- Smart heuristics (typo detection, vague word warnings, context enhancement)
- No downloads required - works out of the box!
- Optional ML models for advanced suggestions
🔧 Critical Bug Fixes
✅ Fixed: --update Infinite Loop
- Proper version comparison prevents endless update prompts
- Config backup & restore during updates
- Update logging to
~/.commit_checker_cache/update.log - Graceful fallback if update fails
✅ Fixed: "No Public Commits Found"
- Prioritizes local git detection using
user.emailfiltering - Detects commits immediately (even before push)
- GitHub API now cached (1-hour) to reduce rate limit issues
- Works on current machine regardless of other devices
🆕 New Commands
| Command | Description |
|---|---|
--suggest [draft] |
AI-powered suggestions with optional draft message |
--download-models |
Download HuggingFace models (optional, for ML fans) |
--refresh-quote |
Manually refresh Wisdom Drop quote |
--repair |
Auto-repair assets, templates, and profile |
📦 Installation
Recommended (Standalone - No pip issues!)
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bashUpgrade from v0.7.2
commit-checker --update🎮 Usage Examples
Daily Inspiration
commit-checker
# Your commit stats + daily Wisdom Drop quote appears automatically!AI-Powered Suggestions (No downloads needed!)
# Analyze staged changes
commit-checker --suggest
# Provide a draft message
commit-checker --suggest "fixed stuff"
# Get context-aware improvements
commit-checker --suggest "update code"Optional: Download AI Models
# For ML-powered suggestions (one-time, ~300MB)
commit-checker --download-modelsRefresh Your Daily Quote
commit-checker --refresh-quote🛠️ What's Under the Hood
New Modules
wisdom.py- Wisdom Drop integration with smart date parsingcontext.py- Git diff context extraction & conventional commit detectionai_handler.py- Intelligent heuristics + optional ML models
Enhanced Features
- Smart heuristics detect vague words ("stuff", "things") and suggest specifics
- Typo checking for common mistakes ("teh", "recieve", etc.)
- Context-aware verb suggestions based on diff analysis
- GitHub API caching (1-hour) for offline resilience
- Profile integration compares to your average commit patterns
Dependencies
Required (lightweight):
requests,colorama,packaging,textual,plotext,markdown
Optional (AI models):
transformers(via--download-models)torch(via--download-models)
Python: 3.7+ (3.13 recommended for best AI compatibility)
📊 Statistics
- 1,141 lines added across 13 files
- 3 new modules for AI features
- 4 critical bugs fixed
- 4 new CLI commands
- Zero breaking changes - fully backward compatible!
🎯 What's Next (v0.8.0)
Coming soon:
- 🔌 VS Code extension with dashboard panel
- 🤝 Real-time collaboration features
- 🎨 More Wisdom Drop categories (coding/mindfulness/craft)
- 🧠 Custom AI model training from your commit history
🐛 Known Issues
None! But if you find any, please open an issue.
🙏 About the Creator
@AmariahAK - Solo Creator & Maintainer
Related Projects:
- 🟢 commit-checker - Keep your GitHub streak alive
- 💡 Wisdom Drop - Daily motivational quotes for developers
Both projects built with ❤️ to help developers stay motivated and productive!
☕ Support Development
If commit-checker helps you maintain your streak and write better commits, consider supporting:
📋 Full Changelog
See CHANGELOG.md for detailed changes.
🚀 Get Started
# Install
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
# First time setup
commit-checker --init
# Daily check (with Wisdom Drop!)
commit-checker
# Get AI suggestions
commit-checker --suggest "your message"Happy coding! Keep that streak alive! 🔥
🥸 v0.7.5.1 - UX Fixes
🔧 commit-checker v0.7.5.1 - UX Fixes
Patch release fixing Wisdom Drop display and commit messaging
🐛 Bug Fixes
Fixed Wisdom Drop Quote Display
- Issue: Quotes were displaying with double quotes (
""Quote"") - Fix: Strips extra quotes for clean display
- Result:
💡 Wisdom Drop: "Quote" — Author, Category✅
Fixed Misleading "No Public Commits" Message
- Issue: Showed
😢 No public commits found todayeven when local commits existed - Fix: Reordered display - local commits shown FIRST, before GitHub check
- New behavior:
- ✅ Local commits display immediately (instant satisfaction!)
- ℹ️ GitHub shows contextual message:
"No commits pushed to GitHub yet (local commits not yet pushed)" - Only shows sad emoji when truly no commits anywhere
Added Debug Flag
- New:
commit-checker --debugflag for troubleshooting - Shows detailed error messages for Wisdom Drop and other features
- Helps diagnose issues without breaking normal flow
📊 What Changed
Before v0.7.5.1:
commit-checker
🌐 GitHub: @AmariahAK
😢 No public commits found today. # ❌ Shown even with local commits!
🗂️ Scanning 1 local path(s):
🟩 Local Commits:
2 commits today # ✅ But they're here!After v0.7.5.1:
commit-checker
🗂️ Scanning 1 local path(s):
🟩 Local Commits:
2 commits today # ✅ Shown FIRST!
🌐 GitHub: @AmariahAK
ℹ️ No commits pushed to GitHub yet (local commits not yet pushed) # ✅ Clear message!🚀 Installation
Update from v0.7.5
commit-checker --updateFresh Install
# Standalone (recommended)
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
## 📝 Full v0.7.5.x Feature Set
This patch release includes all v0.7.5 features:
- 💡 **Wisdom Drop Integration** - Daily motivational quotes
- 🤖 **AI Commit Context** - Smart suggestions from git diff analysis
- 🔧 **Fixed --update loop** - No more infinite update prompts
- 📦 **Standalone support** - All new modules available in curl install
- 🧠 **Smart heuristics** - AI suggestions work WITHOUT model downloads
## 🔗 Related
- **Full v0.7.5 Release**: See [v0.7.5 release notes](https://github.com/AmariahAK/commit-checker/releases/tag/v0.7.5)
- **Wisdom Drop**: https://github.com/AmariahAK/wisdom-drop
## 💻 Technical Details
**Files Changed:**
- `commit_checker/cli.py` - Reordered commit display logic
- `commit_checker/wisdom.py` - Strip extra quotes from parsed quotes
- `setup.py`, `updater.py` - Version bump to 0.7.5.1
**Commits:**
- `793a6c2` - Version bump to 0.7.5.1
- `75ecdfb` - Reorder commit display and improve messaging
- `4bd47ef` - Fix Wisdom Drop quote display and add debug flag
## 🙏 Feedback
Found an issue or have a suggestion? [Open an issue](https://github.com/AmariahAK/commit-checker/issues)
**Happy coding! Keep that streak alive! 🔥**
---🔧 v0.7.2.1 - Standalone Script Complete Fix
🔧 v0.7.2.1 - Standalone Script Complete Fix
Finally! Full Smart Profile System for standalone users
🎯 Critical Standalone Installation Fix
This patch resolves the remaining issues preventing standalone users (curl/bash installations) from accessing the complete Smart Profile System.
🐛 What Was Still Broken in v0.7.1
Even after v0.7.1, standalone users experienced:
commit-checker --build-profile
❌ Profile building failed: cannot access local variable 'script_dir'
commit-checker --version
❌ error: unrecognized arguments: --version
commit-checker --insights
❌ Fell through to normal commit checking instead of showing insights
✅ What's Fixed in v0.7.2.1
🔧 Standalone Script Architecture Fixed
Fixed variable scoping issues in standalone script execution
Proper function imports for all Smart Profile System features
Enhanced error handling with graceful fallbacks
Complete feature parity between pip and standalone installations
📱 Added --version Flag
commit-checker --version
🚀 commit-checker v0.7.2.1
📅 Smart Profile System
🔗 https://github.com/AmariahAK/commit-checker
🛡️ Bulletproof Standalone Mode
All profile commands now work identically to pip installations
Improved module loading with better error diagnostics
Cache invalidation fixes for proper updates
📈 Confirmed Working: Full Feature Set
✅ All of these now work perfectly in standalone mode:
commit-checker --build-profile
🧙 Building your smart coding profile...
✅ Profile built successfully! 📈 Analyzed 7 repositories
commit-checker --insights
🧠 Personal Coding Insights
📊 Tech Stack Distribution: Python: 4 repos (57%)
commit-checker --coach "fixed stuff"
💡 Casual style detected—add detail? E.g., fixed stuff → fixed login crash
commit-checker --feedback good
👍 Thanks! Tuned your preferences.
commit-checker --version
🚀 commit-checker v0.7.2
🚀 Installation & Upgrade
For Existing Standalone Users (RECOMMENDED)
Clear cache and get fresh v0.7.2 files
rm -rf ~/.commit-checker-standalone
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
For New Users
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
Alternative Update Method
commit-checker --update
🎯 Why This Release Matters
Before: Only pip/pipx users could use Smart Profile features
After: 100% of users get the complete adaptive coaching experience
This ensures the majority of users (who use the recommended standalone installation) can access all the AI-like personalization features that make commit-checker special.
🔧 Technical Details
Root Cause: Standalone script had incomplete command handlers and variable scoping issues
Solution: Complete rewrite of standalone profile system integration
Testing: Verified on fresh installations and cache-cleared environments
📋 Upgrade Priority
🚨 CRITICAL for:
Standalone users (installed via curl | bash)
Anyone experiencing "Profile building failed" errors
Users wanting to access --build-profile, --insights, --coach
Priority Level: IMMEDIATE - This fixes the core Smart Profile System for 90% of users
Full Changelog: v0.7.1...v0.7.2
After this release: The Smart Profile System finally works for EVERYONE! 🎉
🔧 v0.7.2 - Standalone Script Fixes
🔧 v0.7.2 - Standalone Script Complete Fix
Finally! Full Smart Profile System for standalone users
🎯 Critical Standalone Installation Fix
This patch resolves the remaining issues preventing standalone users (curl/bash installations) from accessing the complete Smart Profile System.
🐛 What Was Still Broken in v0.7.1
Even after v0.7.1, standalone users experienced:
commit-checker --build-profile
❌ Profile building failed: cannot access local variable 'script_dir'
commit-checker --version
❌ error: unrecognized arguments: --version
commit-checker --insights
❌ Fell through to normal commit checking instead of showing insights
✅ What's Fixed in v0.7.2
🔧 Standalone Script Architecture Fixed
Fixed variable scoping issues in standalone script execution
Proper function imports for all Smart Profile System features
Enhanced error handling with graceful fallbacks
Complete feature parity between pip and standalone installations
📱 Added --version Flag
commit-checker --version
🚀 commit-checker v0.7.2
📅 Smart Profile System
🔗 https://github.com/AmariahAK/commit-checker
🛡️ Bulletproof Standalone Mode
All profile commands now work identically to pip installations
Improved module loading with better error diagnostics
Cache invalidation fixes for proper updates
📈 Confirmed Working: Full Feature Set
✅ All of these now work perfectly in standalone mode:
commit-checker --build-profile
🧙 Building your smart coding profile...
✅ Profile built successfully! 📈 Analyzed 7 repositories
commit-checker --insights
🧠 Personal Coding Insights
📊 Tech Stack Distribution: Python: 4 repos (57%)
commit-checker --coach "fixed stuff"
💡 Casual style detected—add detail? E.g., fixed stuff → fixed login crash
commit-checker --feedback good
👍 Thanks! Tuned your preferences.
commit-checker --version
🚀 commit-checker v0.7.2
🚀 Installation & Upgrade
For Existing Standalone Users (RECOMMENDED)
Clear cache and get fresh v0.7.2 files
rm -rf ~/.commit-checker-standalone
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
For New Users
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
Alternative Update Method
commit-checker --update
🎯 Why This Release Matters
Before: Only pip/pipx users could use Smart Profile features
After: 100% of users get the complete adaptive coaching experience
This ensures the majority of users (who use the recommended standalone installation) can access all the AI-like personalization features that make commit-checker special.
🔧 Technical Details
Root Cause: Standalone script had incomplete command handlers and variable scoping issues
Solution: Complete rewrite of standalone profile system integration
Testing: Verified on fresh installations and cache-cleared environments
📋 Upgrade Priority
🚨 CRITICAL for:
Standalone users (installed via curl | bash)
Anyone experiencing "Profile building failed" errors
Users wanting to access --build-profile, --insights, --coach
Priority Level: IMMEDIATE - This fixes the core Smart Profile System for 90% of users
After this release: The Smart Profile System finally works for EVERYONE! 🎉
🐛 v0.7.1 - Stability & Bug Fixes
🐛 v0.7.1 - Stability & Bug Fixes
Polishing the Smart Profile System to perfection
🎯 What's Fixed
This patch release resolves critical stability issues in v0.7.0 and enhances the overall user experience of the Smart Profile System.
🐛 Critical Bug Fixes
✅ Fixed Command Exit Errors
Issue: UnboundLocalError: cannot access local variable 'sys' causing commands to fail with exit code 1
Root Cause: Local import shadowing global sys module
Fix: Removed duplicate import, all commands now exit cleanly with code 0
Impact: All profile commands (--build-profile, --coach, --insights) now work flawlessly
🛡️ Enhanced Install Script Stability
Issue: Occasional "cho: command not found" errors during installation
Improvement: Added set -e for better error handling and script robustness
Result: More reliable installation process across different environments
⚡ Performance & Stability Improvements
🔧 Refined Adaptive Coaching
Enhanced freeform detection accuracy - Better identification of casual vs formal commit styles
Improved suggestion quality - More contextual and helpful recommendations
Optimized analysis speed - Faster commit history parsing and pattern recognition
📊 Profile System Optimizations
Faster profile building - Reduced scanning time for large repositories
Better error handling - Graceful fallbacks for edge cases (empty repos, git errors)
Memory efficiency - Optimized data structures for profile storage
🎵 Audio Feedback Reliability
Consistent sound notifications - Fixed edge cases where audio didn't play
Cross-platform compatibility - Improved sound handling on macOS/Linux/Windows
🚀 Installation & Upgrade
Upgrade Existing Installation
commit-checker --update
Fresh Installation
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
📈 Verified Functionality
All core v0.7.0 features working perfectly:
Build your profile (now error-free!)
commit-checker --build-profile
Get personalized coaching
commit-checker --coach "fixed stuff"
💡 Casual style detected—add detail? E.g., fixed stuff → fixed login crash
Tune your preferences
commit-checker --coach "update code" --feedback bad
👍 Got it! Less prefix suggestions.
View insights
commit-checker --insights
📊 Tech Stack Distribution: Python: 4 repos (57%), JavaScript: 2 repos (29%)
🎯 What's Still Coming
v0.8.0: VS Code Extension with real-time dashboard
Enhanced team collaboration features
Advanced AI integration options
🛠️ Technical Details
Files Changed:
cli.py - Removed duplicate sys import causing exit errors
install-standalone.sh - Added error handling for better reliability
Version bumped to 0.7.1 across all configuration files
Compatibility:
All existing v0.7.0 profiles remain compatible
No breaking changes to commands or configuration
Seamless upgrade path from any previous version
Priority: Recommended upgrade for all v0.7.0 users experiencing command exit errors.
🧠 v0.7.0 - Smart Profile System
🧠 v0.7.0 - Smart Profile System
Making commit-checker your personal coding coach
🎉 What's New
This release transforms commit-checker into an adaptive, personalized coding assistant that learns your style and provides intelligent suggestions without disrupting your workflow.
🧠 Adaptive Commit Message Coaching
Freeform Style Detection: Automatically detects if you prefer casual commit messages ("fixed stuff") vs formal prefixes ("feat: fix bug")
Smart Suggestions:
Traditional users get prefix/case/emoji suggestions
Casual users get clarity suggestions: "fixed stuff" → "fixed login crash"
Learning System: Use --feedback good/bad to tune suggestions to your preferences
Vague Word Detection: Identifies unclear terms and suggests specific alternatives
📚 Expanded Tech Stack Detection
Added support for 7 new languages/frameworks:
PHP (composer.json/lock)
Swift (Podfile, Package.swift)
Kotlin (build.gradle.kts)
Elixir (mix.exs)
Scala (build.sbt)
Haskell (cabal.project, package.yaml)
TypeScript (tsconfig.json)
💡 New Smart Suggestions
Commit Size Nudges
Large commits (>100 lines): Suggests splitting into smaller commits
Tiny commits (<5 lines): Suggests bundling with related changes
Smart detection: Excludes documentation from tiny commit warnings
TIL Tag Recommendations
Auto-suggests tags based on current repository context
Keyword detection: Finds "async", "testing", "debug" in commits → suggests relevant tags
Non-disruptive: Only appears when you haven't specified a tag
🔧 Enhanced Stack-Aware Suggestions
Now supports 13+ languages with contextual suggestions:
💡 PHP: Run 'composer install' for lockfile?
💡 Swift: Update pods?
💡 Kotlin: Gradle sync?
💡 TypeScript: Run 'tsc' to compile?
💡 Elixir: Run 'mix deps.get'?
🆕 New Commands
--feedback good/bad - Tune coaching preferences
Enhanced --coach - Now includes commit size analysis
Enhanced --insights - Shows freeform vs structured style breakdown
🎵 Audio Feedback
suggest.wav plays when showing suggestions
notify.wav plays when operations complete or feedback is processed
📈 Example Usage
Adaptive Coaching in Action
For casual style users (>80% unprefixed commits)
$ commit-checker --coach "fixed stuff"
💡 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'
Traditional style gets different suggestions
$ commit-checker --coach "fix auth bug"
💡 Your 'blog-api' uses 'feat:'—try 'feat: fix auth bug'?
Tune your preferences
$ commit-checker --coach "update code" --feedback bad
👍 Got it! Less prefix suggestions.
Smart TIL Tags
$ commit-checker til "learned async patterns"
💡 Add --tag python? (detected Python repo)
💡 Add --tag async? (detected 'async' context)
Enhanced Insights
$ commit-checker --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%)
• TypeScript: 1 repos (17%)
⚡ Technical Highlights
Lightweight: <100 new lines of code, no new dependencies
Cross-platform: Works on macOS, Linux, Windows
Resilient: Graceful fallbacks for git errors and edge cases
Non-disruptive: All suggestions are optional, never blocks workflow
Performance: Shallow repository scanning (2 levels max, 50 commits limit)
🚀 Installation & Upgrade
New Installation
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
Upgrade Existing Installation
commit-checker --update
First-Time Profile Setup
commit-checker --build-profile
🎯 What's Next
v0.8.0: VS Code Extension with dashboard panel
Enhanced AI integration with local models
Team collaboration features
🐛 Bug Fixes & Improvements
Enhanced error handling for empty repositories
Improved tech stack detection accuracy
Better Unicode handling in commit message analysis
Optimized profile building performance
📚 Documentation
Updated README with new features and examples
Enhanced command documentation
Added troubleshooting guide for profile system
Try it now: commit-checker --build-profile and let your coding coach learn your style! 🚀
🚨 Critical Fixes
🚨 Critical Fixes
- GitHub API Authentication Solution
🔧 Fixed 401 Unauthorized errors - Enhanced error handling for GitHub API rate limits
⚠️ Better error messages - Clear guidance when authentication is required
🎯 Optional GitHub tracking - New option to skip GitHub checks entirely
💡 Setup wizard integration - Choose "local commits only" during configuration
🔄 Graceful fallbacks - Tool continues working even if GitHub API fails - Standalone Installation Fixes
🔧 Fixed import errors - ImportError: attempted relative import resolved
📥 Enhanced update system - Standalone installations now update via curl download
🎯 Installation type detection - Automatically detects standalone vs pip installations
⚡ No more pip errors - Standalone users won't see irrelevant pip update failures - Nuclear Uninstall System
☢️ Enhanced --uninstall - Removes ALL traces from system (8 shell files, all directories)
🔍 Comprehensive cleanup - Scans all possible binary locations and config files
🧹 Shell file cleaning - Thoroughly removes auto-run commands from all shell configs
♻️ Fresh start ready - Perfect preparation for clean reinstalls
🛠️ For ALL Current Users
🚨 If You're Getting 401 GitHub API Errors:
Quick Fix (30 seconds):
commit-checker --setup
Choose: "2. Skip GitHub checks (local commits only)"
OR Add GitHub Token:
1. Go to: https://github.com/settings/tokens
2. Create token (no special permissions needed)
3. commit-checker --setup
4. Enter username and paste token
🔄 If You're Getting Update/Import Errors:
Nuclear Fresh Install (2 minutes):
Step 1: Complete removal
commit-checker --uninstall
Step 2: Restart terminal
exit
(open new terminal)
Step 3: Fresh install
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bash
Step 4: Run
commit-checker
🎯 What This Fixes
❌ Before: "401 Unauthorized" errors breaking user experience
✅ After: Optional GitHub checks with clear error messages
❌ Before: --update command failing for standalone users
✅ After: Smart update system that detects installation type
❌ Before: Import errors in standalone mode
✅ After: Robust import fallbacks for all deployment methods
❌ Before: Incomplete uninstall leaving traces causing conflicts
✅ After: Nuclear uninstall removes everything for clean slate
🔮 Preparing for v0.7 VS Code Extension
This critical patch creates the stable foundation for the upcoming VS Code extension:
🎯 Clean installation base - No conflicts or leftover files
🔧 Reliable update mechanism - Updates will work smoothly for VS Code extension
⚡ Error-free operation - Eliminates GitHub API friction