v1.5.2: Fix certificate errors on Macs without Homebrew

• Fixes CERTIFICATE_VERIFY_FAILED on Macs without Homebrew: the app now verifies HTTPS with its own bundled CA certificates.

If you have 1.5.0 or 1.5.1, click the meter and choose Check for Updates, or wait for the daily check. If the update check fails, download the DMG below and install it over the old copy.

v1.5.1: Tidier update menu item

• The menu item now reads Check for Updates, without the trailing ellipsis.

This is the first release delivered by Sparkle: if you have 1.5.0, click the meter and choose Check for Updates, or wait for the daily check.

v1.5.0: Automatic updates, new icon, website

Automatic updates, a new icon, and a website

Download ClaudeUsageMeter.dmg, open it, and drag Claude Usage Meter into Applications. Requires Apple Silicon and macOS 26 or later, and Claude Code signed in with a Claude subscription.

What's new

• Automatic updates. The app checks for new versions once a day, and Check for Updates… in the menu checks right away. Updates are signed and verified before they install. This release is the last one you need to install by hand.
• New icon, in the same family as Quoth, Plainview and Gaugeline.
• Website: victorshammas.com/claude-usage-meter, with support and privacy pages.
• One typeface: the whole menu now uses the meters' monospaced face, and Quit sits apart under its own separator.
• Fixed: Launch at Login was missing from the menu in 1.4.0. After updating, click the meter and turn it on.

Updating from 1.4.0

Quit the running app (click the meter, then Quit), drag the new version into Applications to replace it, and open it again.

v1.4.0: Claude Usage Meter, now a Mac app

Claude Usage Meter is now a Mac app

Download ClaudeUsageMeter-1.4.0.dmg below, open it, and drag Claude Usage Meter into Applications. No Python, pip or LaunchAgent setup needed. The app is signed with a Developer ID and notarized by Apple, so it opens without Gatekeeper warnings.

Requires Apple Silicon and macOS 26 or later, plus Claude Code logged in with a Claude subscription. Other Macs can keep running from source.

What's new

• Signed, notarized app bundle, distributed as a DMG
• Renamed to Claude Usage Meter. The repository moved to victor-shammas/claude-usage-meter; old links redirect.
• Launch at Login toggle in the dropdown, registered with System Settings → General → Login Items
• About panel with links to GitHub and Buy me a coffee
• Re-authenticate no longer needs Automation permission to open Terminal
• Quit now has a Cmd+Q shortcut

Upgrading from the script version

Remove the old LaunchAgent first, or you'll get two meters:

launchctl unload ~/Library/LaunchAgents/com.claude-usage-menubar.plist
rm ~/Library/LaunchAgents/com.claude-usage-menubar.plist

Meter not visible? On MacBooks with a notch, macOS hides menu bar items that would sit under the camera when the bar is crowded. Hide a few other items (Cmd-drag them out) to make room.

SHA-256: 49aa62ef5b473397ab35d4ccd32365175f254b1f5e009485f35de3df95b8240d