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 🧠⚙️
- ✅ 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
- ✅ 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
- ✅ 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
- ✅ 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)
- ✅ 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
- ✅ 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
- ✅ 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
- ✅ 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 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
- ✅ 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 (
--diagnose) for troubleshooting - ✅ Installation Method Detection (pip, pipx, standalone)
- ✅ Dependency Verification and environment analysis
- ✅ Configuration Validation with automatic migration
- ✅ 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
v0.8.5 Update: Advanced AI Integration with 4 model options (TensorFlow, Ollama, Together AI, Heuristic). All installation methods updated.
curl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-safe.sh | bashcurl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh -o /tmp/install.sh
chmod +x /tmp/install.sh
/tmp/install.shcurl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/scripts/install-standalone.sh | bashcurl -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.shcurl -s https://raw.githubusercontent.com/AmariahAK/commit-checker/main/install.sh | bashOn 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:Basic usage:
commit-checkerAll available commands:
Setup & Configuration:
commit-checker --init- Interactive setup wizard (recommended for first-time users)commit-checker --setup- Quick reconfigure settingscommit-checker --diagnose- Run system diagnostics
🧠 Smart Profile System (v0.7.0):
commit-checker --build-profile- Build/rebuild your personalized coding profilecommit-checker --coach "fix user auth"- Get commit message coaching suggestionscommit-checker --feedback good/bad- Give feedback on coaching suggestions to tune preferencescommit-checker --insights- Show personalized coding insights and habitscommit-checker --no-profile- Skip profile-based suggestions for this run
Core functionality:
commit-checker- Check today's commits with gamificationcommit-checker --scan- Scan repo folder for all git repositoriescommit-checker --repos-summary- Show full summary of all reposcommit-checker --most-active- Show most active repository todaycommit-checker --most-active --week- Show most active repo this weekcommit-checker --most-active --month- Show most active repo this monthcommit-checker --stats- Show ASCII commit trend charts (30 days)
🎮 Gamification & Progress:
commit-checker --achievements- Display achievement gallery with ASCII artcommit-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 heatmapcommit-checker --heatmap-export svg- Export heatmap to SVG filecommit-checker --stats-lang- Programming language breakdown with chartscommit-checker --time-stats- Commit timing analysis (morning/afternoon/evening/night)commit-checker --dashboard- Quick stats overview (commits today, streak, XP, top repo)commit-checker --suggest- Analyze latest commit message and suggest improvements
📚 Enhanced TIL (Today I Learned) Vault System:
commit-checker til "Your learning today"- Add a TIL entry to logcommit-checker til "Fixed bug" --template bugfix- Use template for vault entrycommit-checker --list-templates- Show available TIL templatescommit-checker --add-template NAME "STRUCTURE"- Create custom TIL templatescommit-checker --til-vault- Show TIL vault summary with statscommit-checker --search-til "async"- Fuzzy search TIL entriescommit-checker --til-from-diff- Generate TIL from latest commit changescommit-checker --view-til- View your complete TIL logcommit-checker --view-til --filter-tag python- View TIL entries by tagcommit-checker --edit-til- Edit TIL log in your default editorcommit-checker --export md- Export TIL to Markdown filecommit-checker --export json- Export TIL to JSON filecommit-checker --reset-til- Clear all TIL entries (with confirmation)commit-checker til "Entry" --no-date- Add entry without date header
System commands:
commit-checker --update- Manually check for updatescommit-checker --uninstall- Remove completely (with PEP 668 support)commit-checker --uninstall --force- Remove without confirmationcommit-checker --support- Show support infocommit-checker --silent- Minimal outputcommit-checker --nocolor- Disable emojis/colors
macOS: ~/Documents/GitHub, ~/Developer, ~/Desktop/GitHub
Linux: ~/workspace, ~/devel, /var/www
Windows: ~/source, C:\Projects, C:\xampp\htdocs
commit-checker/
├── 📄 LICENSE.md # MIT License
├── 📖 README.md # This file
├── 📦 setup.py # Python package setup (pip version)
├── 📋 requirements.txt # Python dependencies
├── 🚀 install.sh # Git clone installation
├── scripts/ # Standalone versions
│ ├── 🎯 install-standalone.sh # Standalone installer
│ └── 🚀 commit-checker-standalone.sh # Standalone script
└── commit_checker/ # Core Python modules
├── 🔧 __init__.py # Package initialization
├── ✅ checker.py # Commit checking logic
├── ⚙️ config.py # Configuration management
├── 🔍 path_detector.py # Smart path detection
└── 🔄 updater.py # Auto-update functionality
If this tool helps you stay consistent, focused, or productive — consider supporting development!
Or visit: https://buymeacoffee.com/amariahak
Amariah Kamau
📂 GitHub: @AmariahAK
🌐 Portfolio: https://portfolio-pied-five-61.vercel.app
Licensed under the MIT License.
Track your daily learnings with commit-checker's built-in TIL functionality:
# Add a learning entry
commit-checker til "Learned how to use async/await in Python"
# View your TIL log
commit-checker --view-til
# Edit in your preferred editor
commit-checker --edit-til# Today I Learned
## July 22, 2025
- Learned how to use async/await in Python
- Discovered that Git hooks can automate code quality checks
- Found out about the --no-ff flag in Git merge
## July 21, 2025
- Learned about CSS Grid layout properties
- Discovered Docker multi-stage builds for smaller images# Add entry without date grouping
commit-checker til "Quick tip" --no-date
# Reset all entries (with confirmation)
commit-checker --reset-tilTIL Storage: Entries are saved to ~/.commit-checker/til.md and persist between sessions unless manually deleted.
$ commit-checker
🌐 GitHub: @AmariahAK
😢 No public commits found today.
🗂️ Scanning 1 local path(s):
📁 /Users/you/Documents/GitHub
🟩 Local Commits:
📁 Repository: commit-checker
📍 Path: /Users/you/Documents/GitHub/commit-checker
📊 3 commit(s) today:
e05feb7 feat: implement v0.6.1 - Critical Fixes & Enhanced Reliability
⚡ 3 commits today | +2305 XP | 1🔥 streak | 🚀 Coding machine!
💫 +2305 XP earned today!
🎉 LEVEL UP! You're now level 7!
🏆 New achievements unlocked:
🟩 Hello World
🟨 Code Tsunami
🔥 Current streak: 1 days
$ commit-checker --xp
⚡ Level 7: Framework Knight
💫 Total XP: 4,499
📊 Progress: [██░░░░░░░░░░░░░░░░░░] 12.5%
🎯 Next Level: 3,501 XP needed
📈 Commits Tracked: 2
$ commit-checker --achievements
🏆 Achievement Gallery
==================================================
🟩 COMMON BADGES
🟩 Hello World
Made your first tracked commit
🟨 EPIC BADGES
🟨 Code Tsunami
Single commit with 500+ line changes$ commit-checker --heatmap
📅 Commit Heatmap (Last 365 days)
==================================================
01/28: ░ ░ ░ ░ ░ ░ ░
02/04: ░ ░ ░ ░ ░ ░ ░
...
07/20: ░ ▓ ▒ ▒ ▒ ▒ ░
07/27: ▓ █ ▓ ▒ ░ ░ ░
Legend: ░ None ▒ Low ▓ Medium █ High
Max commits in a day: 5
Last 7 days: 12 commits
$ commit-checker --stats-lang
📊 Programming Language Breakdown
==================================================
Python [████████████████░░░░░░░░░░░░░░] 54.1% (3,274 lines, 47 files)
JavaScript [███████░░░░░░░░░░░░░░░░░░░░░░░] 23.2% (1,405 lines, 23 files)
TypeScript [████░░░░░░░░░░░░░░░░░░░░░░░░░░] 13.1% (793 lines, 12 files)
CSS [██░░░░░░░░░░░░░░░░░░░░░░░░░░░░] 6.8% (412 lines, 8 files)
Markdown [█░░░░░░░░░░░░░░░░░░░░░░░░░░░░░] 2.8% (169 lines, 5 files)
📈 Total: 6,053 lines across 95 files$ commit-checker --list-templates
📚 Available TIL templates:
• algorithm
• bugfix
• concept
• feature
• tool
Usage: commit-checker til "Title" --template algorithm
$ commit-checker til "Fixed async race condition" --template bugfix
TIL created: /Users/you/.commit-checker/tils/2025-07-28-fixed-async-race-condition.md
$ commit-checker --til-vault
📚 TIL Vault Summary
==================================================
📁 Location: /Users/you/.commit-checker/tils/
📄 Total entries: 5
📝 Recent entries:
• 2025-07-28: Fixed async race condition #bugfix #async
• 2025-07-27: Implemented new caching layer #feature #performance
• 2025-07-26: Understanding Docker volumes #concept #docker
🏷️ Popular tags:
#bugfix (2)
#feature (1)
#concept (1)
$ commit-checker --search-til "async"
🔍 Found 2 TIL entries:
==================================================
1. 📝 Fixed async race condition
📅 2025-07-28 | Score: 10
L1: # Fixed async race condition
L15: - Used asyncio.Lock() to prevent race conditions
2. 📝 Understanding async patterns
📅 2025-07-26 | Score: 5
L8: - async/await syntax in Python$ commit-checker --init
🧙♂️ Welcome to commit-checker Interactive Setup Wizard!
🌐 GitHub Configuration
👤 GitHub username: AmariahAK
📁 Development Folder Configuration
🔍 Found these potential development folders:
1. /Users/you/Documents/GitHub (15 git repos found)
2. /Users/you/Developer (8 git repos found)
🎨 Output Style Configuration
1. 🎉 Emoji mode (colorful with emojis)
2. 📝 Plain mode (simple text only)
📚 TIL Configuration...
🎉 Configuration saved!$ commit-checker --stats
📊 Commit Statistics (Last 30 Days)
==================================================
📁 commit-checker
Total commits: 18
Trend: ▁▂▃█▇▆▅▃▂▁▃▄▅▇█▇▅▃▂▁▂▄▅▆▇█▇▅▃▂▁
Recent: 2025-07-23: 2, 2025-07-24: 3, 2025-07-25: 5
📁 my-website
Total commits: 12
Trend: ▁▁▂▃▄▅▆▇█▇▆▅▄▃▂▁▁▂▃▄▅▆▇█▇▆▅▄▃▂▁
Recent: 2025-07-23: 1, 2025-07-24: 2, 2025-07-25: 4$ commit-checker til "Learned about async/await in Python" --tag python
✅ TIL entry added (tagged: python)
$ commit-checker --view-til --filter-tag python
# Today I Learned
## July 25, 2025
- Learned about async/await in Python `#python`
- Python decorators can modify function behavior `#python`
$ commit-checker --export json
📊 TIL exported to ~/til_export_20250725_143022.json$ commit-checker --diagnose
🔍 System Diagnostics
==============================
🐍 Python version: 3.11.5
📦 Git: git version 2.39.0
📦 Package: Installed via pip (v0.5.0)
⚙️ Config: Found at ~/.commit-checker/config.json
GitHub user: AmariahAK
Local paths: 2 configured
Output mode: emoji
📚 Dependencies:
✅ requests: Available
✅ packaging: Available
✅ colorama: Available
🐍 Environment: Virtual environment
📦 pipx: Available but commit-checker not installed via pipx
✅ Diagnostics complete!$ commit-checker --scan
🔍 Scanning /Users/you/Documents/GitHub for git repositories...
📁 Scanned 6 repos:
commit-checker → ✅ 2 today | 🧮 41 total | 🕒 Today
blog-api → ❌ 0 today | 🧮 89 total | 🕒 Jul 17
my-website → ✅ 1 today | 🧮 156 total | 🕒 Today$ commit-checker --build-profile
🧙 Building your smart coding profile...
📊 Analyzing commit history patterns...
🔍 Detecting project tech stacks...
📁 Scanning project structures...
✅ Profile built successfully!
📈 Analyzed 6 repositories
💡 Smart suggestions now enabled
$ commit-checker --coach "fixed stuff"
🔍 Analyzing: "fixed stuff"
💡 Suggestions:
💡 Casual style detected—add detail? E.g., fixed stuff → fixed login crash
💡 'stuff' is vague—what specifically? E.g., 'fixed login stuff' → 'fixed login validation'
$ commit-checker --coach "fix auth bug" --feedback good
🔍 Analyzing: "fix auth bug"
💡 Suggestions:
💡 Your 'blog-api' uses 'feat:'—try 'feat: fix auth bug'?
👍 Thanks! Tuned your preferences.
$ commit-checker --insights
🧠 Personal Coding Insights
==================================================
📊 Overall Style:
• Average commit length: 7.5 words
• Preferred mood: Imperative
• Uses emojis: No
📁 Repository Analysis (6 repos):
🔧 Tech Stack Distribution:
• Python: 4 repos (67%)
• Javascript: 2 repos (33%)
• Cli: 1 repos (17%)
📝 Commit Style Breakdown:
• Imperative: 4 repos (67%)
• Lowercase: 2 repos (33%)
🕒 Profile last updated: 2025-09-18 12:10
$ commit-checker til "Learned async patterns"
💡 TIL Tag Suggestions:
💡 Add --tag python? (detected Python repo)
💡 Add --tag async? (detected 'async' context)
✅ TIL entry added
$ commit-checker --coach "refactor everything"
🔍 Analyzing: "refactor everything"
💡 Suggestions:
💡 Large commit (150+ lines, 12 files)—split into smaller commits?
💡 Casual style detected—add detail? E.g., refactor everything → refactored user auth module- 🔧 Fixed Standalone Profile Commands -
--build-profile,--insights,--coachnow work in standalone mode - 📱 Added
--versionFlag - 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
- 🐛 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
- 🧠 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
- 🔍 Commit Message Analysis - New
--suggestcommand analyzes and improves commit messages - 📊 Quick Dashboard - New
--dashboardcommand for instant daily overview - ⏰ Time Analytics - New
--time-statscommand 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
- 🚨 Complete Uninstallation - Fixed
--uninstallleaving shell startup commands, now removes ALL traces - 🛡️ Bulletproof Wizard - Enhanced
--initvalidation 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
$ 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- 🎮 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
- 🧙♂️ 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
- 📝 New TIL Command - Log daily learnings with
commit-checker til "message" - 📁 Local Storage - Entries saved to
~/.commit-checker/til.mdwith smart date organization - 🖊️ Editor Integration -
--edit-tilopens your TIL log in default editor - 👀 View & Reset -
--view-tiland--reset-tilfor easy management - 🔧 Customizable - Configure TIL path via config.json
- 🔄 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
- 🔍 Repository scanning with
--scanflag - 📊 Complete repo summaries with commit statistics
- 🔥 Most active repo detection (daily, weekly, monthly)
- 🎨 Configurable output modes (emoji or plain text)
- 🗑️ Enhanced uninstall with
--forceoption - ⚙️ Persistent configuration with repo folder settings
- 🔍 Smart auto-detection of git repositories
- 🌍 Enhanced cross-platform support
- 📁 Multiple path monitoring
- 🚀 Standalone bash version (no pip issues!)
- 🛠️ Improved setup experience
- ✅ Basic GitHub and local commit tracking
- 🎛️ CLI interface with multiple flags
- 🔄 Auto-update functionality