Repository navigation
Releases
v1.0.8
The 5-hour and Weekly gauges now stay current when you work in the Claude desktop app or on claude.ai, not only in the CLI. Every 5 minutes the app asks Anthropic for your Plan limits, using the login Claude Code keeps in your Keychain. When that login expires, the app refreshes it and saves it back for Claude Code. If Claude Code ever asks you to sign in again, run claude /login. The statusline wrapper is now an optional fallback. The ⚠ shows only when neither source works. Background: ADR 0002.
Install or update (or use the Update to 1.0.8 button in the popover footer):
curl -fsSL https://raw.githubusercontent.com/ghostza1209/ClaudeUsageBar/HEAD/install.sh | shUniversal build (Apple silicon and Intel), macOS 15 or later. Ad-hoc signed, not notarized: the install script avoids the Gatekeeper prompt; for the manual zip see the README.
v1.0.7
On Ultra, which has no 5-hour limit, the popover now hides the 5-hour ring and shows Weekly across the full row, and the menu bar gauge reads Weekly. Before, the 5-hour gauge sat at 0% forever. Pro and Max look the same as before, with one exception: if your first reading after more than 5 hours idle (or a fresh install) has no 5-hour window, the ring stays hidden until your first prompt brings it back.
Install or update (or use the Update to 1.0.7 button in the popover footer):
curl -fsSL https://raw.githubusercontent.com/ghostza1209/ClaudeUsageBar/HEAD/install.sh | shUniversal build (Apple silicon and Intel), macOS 15 or later. Ad-hoc signed, not notarized: the install script avoids the Gatekeeper prompt; for the manual zip see the README.
v1.0.6
Right after a Plan-limits window resets, the menu bar now shows 0% instead of an empty bar with —, and the popover ring reads 0% with "no usage yet" instead of "no data". (Claude Code leaves a fresh window out of its data until it sees usage.)
Install or update (or use the Update to 1.0.6 button in the popover footer):
curl -fsSL https://raw.githubusercontent.com/ghostza1209/ClaudeUsageBar/HEAD/install.sh | shUniversal build (Apple silicon and Intel), macOS 15 or later. Ad-hoc signed, not notarized: the install script avoids the Gatekeeper prompt; for the manual zip see the README.
v1.0.5
Check for updates from Settings: the new App version card shows your version, checks GitHub on demand and tells you whether you're up to date, a newer version is available (with an Install button), or the check failed. A GitHub error such as a rate limit is now reported as a failed check instead of "up to date". The prices button is now called Refresh prices.
Install or update (or use the Update to 1.0.5 button in the popover footer):
curl -fsSL https://raw.githubusercontent.com/ghostza1209/ClaudeUsageBar/HEAD/install.sh | shUniversal build (Apple silicon and Intel), macOS 15 or later. Ad-hoc signed, not notarized: the install script avoids the Gatekeeper prompt; for the manual zip see the README.
v1.0.4
More detailed Usage charts: the Last hour chart has time and token axes, shows its peak and total, and hovering shows the tokens for any minute. The 14 days chart shows the total and daily average, and hovering a bar shows that day's cost, tokens and requests.
Install or update (or use the Update to 1.0.4 button in the popover footer):
curl -fsSL https://raw.githubusercontent.com/ghostza1209/ClaudeUsageBar/HEAD/install.sh | shUniversal build (Apple silicon and Intel), macOS 15 or later. Ad-hoc signed, not notarized: the install script avoids the Gatekeeper prompt; for the manual zip see the README.
v1.0.3
Friendlier Settings: every option has an icon and a one-line explanation, options are grouped by what they affect, and the statusline wrapper shows a clear "Connected to Claude Code" / "Not connected" status with a single Install or Uninstall button.
Install or update (or use the Update to 1.0.3 button in the popover footer):
curl -fsSL https://raw.githubusercontent.com/ghostza1209/ClaudeUsageBar/HEAD/install.sh | shUniversal build (Apple silicon and Intel), macOS 15 or later. Ad-hoc signed, not notarized: the install script avoids the Gatekeeper prompt; for the manual zip see the README.
v1.0.2
Adds an update check: when a newer release is out, the popover footer shows Update to x.y.z, which downloads it, quits and reopens the app. This is the last update you need to install by hand.
Install or update:
curl -fsSL https://raw.githubusercontent.com/ghostza1209/ClaudeUsageBar/HEAD/install.sh | shUniversal build (Apple silicon and Intel), macOS 15 or later. Ad-hoc signed, not notarized: the install script avoids the Gatekeeper prompt; for the manual zip see the README.
v1.0.1
Runs on macOS 15 or later (v1.0.0 required macOS 27, so open failed with error -10825 on older systems). Adds an app icon.
Install or update:
curl -fsSL https://raw.githubusercontent.com/ghostza1209/ClaudeUsageBar/HEAD/install.sh | shUniversal build (Apple silicon and Intel). Ad-hoc signed, not notarized: the install script avoids the Gatekeeper prompt; for the manual zip see the README.
Claude Usage Bar 1.0.0
First release.
Install or update:
curl -fsSL https://raw.githubusercontent.com/ghostza1209/ClaudeUsageBar/HEAD/install.sh | shUniversal build (Apple silicon and Intel), macOS 27 or later. Ad-hoc signed, not notarized: the install script avoids the Gatekeeper prompt; for the manual zip see the README.