cosmo-nz/floating-claude-usage-tracker

Floating Claude Usage Tracker is a small Mac app that shows how much of your Claude AI subscription quota you have used, displayed in a compact floating panel that stays on top of your other windows and can be dragged anywhere on screen. It tracks both the rolling 5 hour usage window and the weekly usage window as percentage bars, each showing how much time has passed in that window and when it resets. There is also an optional menu bar icon if you prefer that over the floating panel. To get live numbers, you sign in to Claude.ai through an embedded login screen inside the app, and the app securely stores your login session in the Mac's Keychain, the same secure storage system macOS uses for passwords. If you separately pay for Anthropic's API by usage, you can optionally turn on API spend tracking by entering an Anthropic admin API key, which adds a row showing your API costs to the panel. A small status indicator at the bottom of the panel also shows whether Claude's services are currently up, pulled from Anthropic's public status page. The app lets you adjust how often it refreshes, from every 10 seconds up to every 5 minutes, and can send a notification when your usage crosses 75, 90, or 95 percent of your quota. It can also be set to launch automatically when you log in to your Mac. The README is upfront that this app relies on unofficial, undocumented data formats from Claude's website and Anthropic's cost reporting system, which could change without warning and break the app's ability to read your usage. Each data source is handled by its own separate piece of code specifically so a break in one does not affect the others. Building the app requires macOS 14 or newer and Xcode 26 with Swift 6.3, and the project includes scripts to build a runnable app or package it into an installer disk image for other people to use.