🚀 Major New Features
Gemini Notification Bridge Integration
- 🔔 Complete notification system for Gemini CLI permission prompts
- 🎯 Settings tab integration with toggle and self-test functionality
- 🔗 codmate://notify URL scheme support for Gemini events (permission, test)
- 📝 Automatic hook management in
~/.gemini/settings.json - 🛡️ Sandbox-aware authorization for directory access when needed
- ⚡ Debounced persistence to prevent excessive file writes during settings changes
Claude Web API Support
- 🌐 Browser cookie authentication as primary method for Claude usage data
- 🍪 Safari cookie extraction from
Cookies.binarycookiesfile - 🌍 Chrome cookie extraction from SQLite database
- 🔄 Automatic fallback to OAuth API when Web API fails
- 📊 Direct claude.ai API integration for more reliable usage tracking
- 🔐 Full Disk Access requirement clearly documented for cookie reading
- 🎯 Plan type detection from organization membership data
Dynamic Usage Donut Icon
- 🎨 Triple-ring donut visualization in menu bar showing Codex/Claude/Gemini usage
- 📊 Real-time usage status with color-coded progress indicators
- 🔄 Automatic icon updates when usage snapshots change
- 🎯 Smart visibility - shows only when usage data is available
- 🎨 Consistent styling with track colors and disabled states
Gemini API Client Enhancements
- 🔄 Automatic token refresh with 5-minute early refresh window
- 🔑 OAuth2 refresh token flow support
- 📝 Flexible token format support (camelCase and snake_case)
- 🎯 Plan type detection from storage and model configurations
- 🛡️ Expiration detection to prevent API failures
- 📦 Legacy oauth_creds.json compatibility
Usage Urgency Algorithm Improvements
- 🎯 Three-stage filtering system for better metric prioritization
- 📊 Depleted limit detection (≤0.1%) with longest reset time priority
- ⏱️ Significant metric filtering (excludes metrics resetting in <5 minutes)
- 📈 Urgency scoring algorithm using consumption × log(1 + reset hours)
- 🔄 Improved metric selection for menu bar and popover display
🎨 UI/UX Improvements
Usage Status Enhancements
- 🔄 Silent refresh mode for background updates without UI disruption
- ⏱️ Throttled refresh with 15-second minimum interval
- 🔔 System notifications for silent refresh failures instead of UI placeholders
- 🎯 Auto-refresh on popover open to ensure latest data visibility
- 📊 Subscription plan type badges displayed in usage menus
- 🎨 Title badge support for plan type indicators (Pro, Max, Team, Enterprise, AI Pro, AI Ultra)
Notification UX Improvements
- 🪟 Window activation suppression when handling codmate://notify URLs
- ⏱️ 1-second delay before resetting activation suppression flag
- 🔄 Non-intrusive notifications that don't interrupt user workflow
Codex Configuration Sync
- 🔄 Automatic preference sync with Codex CLI config.toml
- 📝 TOML parser for reading sandbox_mode and approval_policy defaults
- 🎯 Codex CLI as source of truth - CodMate preferences respect Codex settings
- 🔧 Reduced configuration confusion by keeping settings in sync
Navigation Improvements
- 🎯 Respect .tasks mode when navigating to project settings
- 🛡️ Prevent automatic mode switches when user explicitly navigates to tasks view
- 🔄 Improved navigation consistency and user control
📊 Change Statistics
- Files Changed: 25 files
- Code Changes: +2,316 / -264 lines (net: +2,052 lines)
- Major Additions:
- Browser cookie infrastructure (Safari/Chrome importers)
- Claude Web API client
- Gemini notification bridge system
- Dynamic usage donut icon component
- Usage urgency algorithm improvements
- Major Improvements:
- Usage status refresh with throttling and silent mode
- Codex configuration synchronization
- Gemini API client with auto-refresh
- Menu bar icon with real-time updates
🔐 Security & Privacy
- 🔒 Sandbox-aware cookie access with proper authorization requests
- 🛡️ Full Disk Access requirement clearly documented for Safari cookie reading
- 🔐 Secure token storage with OAuth2 refresh token support
- 📝 Privacy-conscious cookie extraction (only reads specific domains)
🐛 Bug Fixes
- 🎯 Fixed navigation mode switching - respects explicit .tasks mode navigation
- 🔄 Improved usage refresh timing - prevents excessive API calls
- 🪟 Fixed window activation - notification URLs no longer interrupt workflow
Upgrade Recommendation: This release significantly enhances usage tracking reliability with Claude Web API support and browser cookie authentication. The new Gemini notification bridge provides seamless macOS notifications for CLI permission prompts. Dynamic usage donut icons in the menu bar offer at-a-glance status for all providers. Automatic token refresh and configuration sync reduce manual maintenance. Users will benefit from improved usage urgency detection and throttled refresh to prevent API rate limiting.