v1.5.6

Changes

• Removed inaccurate renewal date — the displayed date was calculated from subscription_created_at which doesn't match the actual Stripe billing cycle. The correct renewal date is not available via the OAuth API.

v1.5.5

Fixes

• Fix API connection: switched to valid model ID (claude-haiku-4-5-20251001) — old model was returning 400 errors
• Updated usage labels to match Claude Code /usage output: Current session, Current week, Week (Sonnet)

v1.5.4

Bug Fixes

• Fix crash from concurrent APILog array mutation — APILog.entries was modified from multiple threads when fetch() and fetchProfile() ran in parallel. Added @MainActor isolation for thread-safe access.
• Fix debug window stealing focus — opening the debug panel no longer closes the main menu bar popup.
• Fix plan projection showing "0 days" — minimum elapsed time set to 1 day to avoid misleading projections on fresh windows.

New Features

• Rate limit detection — when the API returns 429 (or any error with rate limit headers), the app now shows actual usage instead of stale data. Works regardless of HTTP status code (429, 404, etc.).
• "Rate limit reached" banner — red warning displayed in the UI when rate limited, auto-clears when limits reset.
• Debug: Rate Limited toggle — test the rate limit banner from the debug panel.
• Live chart bars — the current window bar on 5-Hour and 7-Day charts now reflects live data, not just history snapshots. Responds to debug sliders in real time.

Improvements

• Unified color thresholds — all UI elements (menu bar icon, progress ring, limit rows, chart bars) now use consistent thresholds: green < 70%, yellow 70–89%, red ≥ 90%.
• Debug window positioning — opens offset to the left to avoid overlapping the menu bar popup.

v1.5.0

What's New

• API log timestamps — debug mode now shows HH:mm:ss for each API request

Install

1. Download ClaudeMonitorBar.zip below
2. Unzip and move ClaudeMonitorBar.app to /Applications/
3. On first launch: System Settings → Privacy & Security → Open Anyway

Existing users with auto-update will be prompted automatically.

v1.4.0

What's New

• Debug mode in floating window — opens as a separate panel that stays visible alongside the menu bar popup, so you can adjust mock data sliders and see changes in real time
• Fix: Desktop folder access prompt — no longer triggers macOS permission dialog when running from /Applications
• Fix: Process working directories — all subprocess calls use explicit /tmp working directory

Debug Mode Features

• Mock data sliders (5h, 7d, Sonnet utilization)
• Test notification button
• API request log (endpoint, status code, response time)

Toggle debug mode from Settings → Debug → Open

Install

1. Download ClaudeMonitorBar.zip below
2. Unzip and move ClaudeMonitorBar.app to /Applications/
3. On first launch: System Settings → Privacy & Security → Open Anyway

Existing users with auto-update will be prompted automatically.

v1.3.0

What's New

• Debug Mode — toggle in Settings to access:
  • Mock data sliders (5h, 7d, Sonnet utilization)
  • Test notification button
  • API request log (endpoint, status code, response time)
• API logging — tracks all API calls with timing and error details
• Fix: no more Desktop folder access prompt on launch
• Fix: notifications now display correctly while app is in foreground

Install

1. Download ClaudeMonitorBar.zip below
2. Unzip and move ClaudeMonitorBar.app to /Applications/
3. On first launch: System Settings → Privacy & Security → Open Anyway

Existing users with auto-update will be prompted automatically.

v1.2.0

Claude Monitor Bar v1.2.0

Changes

• Icon style setting (Auto/Light/Dark) with stronger colors
• Check Updates button in settings with "Up to date" confirmation
• Periodic update check every 24h
• Subscription renewal moved under plan name in header
• Auto version injection into Info.plist during build
• Code cleanup: removed 1588 lines of unused legacy code
• Fixed potential crashes (force unwraps → safe guards)
• Updated screenshots in README

Install

1. Download ClaudeMonitorBar.zip below
2. Unzip and move ClaudeMonitorBar.app to /Applications/
3. Go to System Settings → Privacy & Security → click "Open Anyway"

v1.1.0

Claude Monitor Bar v1.1.0

Changes

• Icon style setting (Auto/Light/Dark) with stronger colors
• Check Updates button in settings with "Up to date" confirmation
• Periodic update check every 24h
• Subscription renewal moved under plan name in header
• Code cleanup: removed 1588 lines of unused legacy code
• Fixed potential crashes (force unwraps → safe guards)
• Single version source of truth
• Auto version injection into Info.plist during build

Install

1. Download ClaudeMonitorBar.zip below
2. Unzip and move ClaudeMonitorBar.app to /Applications/
3. Go to System Settings → Privacy & Security → click "Open Anyway"

v1.0.0

Claude Monitor Bar v1.0.0

Native macOS menu bar app for monitoring Claude Code API usage limits in real time.

Features

• Real-time 5-hour, 7-day, and 7-day Sonnet rate limit monitoring
• Color-coded menu bar icon (green/yellow/red) with Auto/Light/Dark style
• Plan recommendation (upgrade/downgrade suggestions)
• Usage history charts (5-hour and 7-day windows)
• Adaptive refresh (scales interval when usage is stable)
• Auto-update from GitHub releases (checks every 24h)
• Notifications at 80%, 90%, 100% thresholds
• Launch at Login
• Subscription plan and renewal date display

Requirements

• macOS 14.0 (Sonoma) or later
• Claude Code installed and authenticated

Install

1. Download ClaudeMonitorBar.zip below
2. Unzip and move ClaudeMonitorBar.app to /Applications/
3. On first launch macOS will block the app (it's not notarized)
4. Go to System Settings → Privacy & Security → scroll down and click "Open Anyway"

The app is open-source and ad-hoc code signed. macOS Gatekeeper blocks apps that aren't notarized by Apple. "Open Anyway" is safe — you can verify the source code in this repo.