v1.7

v1.7 Release Notes

Changes

• Switched to security CLI for keychain access (avoids permission prompts)
• Added fallback to alternate "Claude Code" keychain entry
• Removed first-launch explanation dialog
• Added boot delay - waits for keychain to be ready after system startup
• Auto-updates menu bar reactively via Combine
• Improved error messages with debugging info
• Better retry logic for keychain errors after wake/boot

v1.6.0

Auto-refresh and retry improvements (v1.6.0)

- Fix: Auto-refresh after wake from sleep (3-second delay)
- Fix: Auto-retry on keychain errors (3 attempts, 2-sec delay each)
- Fix: Auto-retry on network errors (3 attempts, 3-sec delay each)
- UI: Added "Created by @richhickson" credit line in footer

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

V1.6.4-Beta

Changed security method.
added error logging.

v1.5.0

The X/Twitter follow button has been relocated to be less intrusive - it's now a small icon in the bottom toolbar that shows a tooltip on hover. This addresses user feedback about the button placement being too prominent.

v1.4.0

Security improvements:

• App Sandbox enabled
• Unused dependency removed
• Dynamic User-Agent
• Request timeouts
• Better error messages

v1.3.2

What's New in v1.3.x

v1.3.2

• Version number now displayed in header for easy reference

v1.3.1

• Fixed app launch issue on some systems

v1.3.0

• Added manual "Check for Updates" button

v1.2.0

• New custom app icon (blue 3-bar chart)

v1.1.0

• Version: 1.1.0
• New features:
  • Launch at Login checkbox
  • Automatic update checking via GitHub releases API
  • Green "Update Available" banner when new version exists

1.0.0

A lightweight macOS menubar app to monitor your Claude Code API usage limits.

Features

• Live usage display in menubar with color-coded status (🟢🟡🔴)
• Session (5-hour) and Weekly (7-day) usage tracking
• Sonnet-only limits display (when available)
• Countdown timers showing when limits reset
• Auto-refresh every 2 minutes

Installation

1. Download ClaudeUsage.zip below
2. Unzip and drag ClaudeUsage.app to your Applications folder
3. Launch the app - it will appear in your menubar

Requirements

• macOS 13.0 (Ventura) or later
• Claude Code CLI installed and logged in

Note

This app reads your Claude Code credentials from the macOS Keychain. Run claude in Terminal and log in first if you haven't already.