AI Tool Atlas
Usage tracker

ClaudeUsageBar

Open-source macOS menu bar app that shows Claude.ai session and weekly usage with alerts at 25, 50, 75 and 90 percent.

Author
Artzainnn
Works with
Claude app (claude.ai)
License
MIT
Documented
Oct 28, 2026
Repository ↗ Official docs ↗

What ClaudeUsageBar is

ClaudeUsageBar displays your Claude.ai session and weekly usage limits in the macOS menu bar with real-time updates and notifications. It refreshes every five minutes and alerts at 25, 50, 75 and 90 percent. Setup requires pasting a claude.ai session cookie copied from the browser's developer tools; the README warns the app uses Claude.ai's internal endpoints, which may change without notice.

What it does

How ClaudeUsageBar plugs in: which agents run it and what it addsRUNS INYour agentClaude app (claude.ai)one host documentedTRACKERClaudeUsageBarShows how much of a plan's usage…4 install steps1 permission notelicense: MITWHAT IT ADDSWhat it doesSession and weekly usage in the m…Alerts at 25, 50, 75 and 90 perce…Refresh every five minutes, Cmd+U…agent → extension → new capability · from the official repository or docs
Where ClaudeUsageBar runs and what it adds, from its documentation
  • Session and weekly usage in the menu bar, colour-coded
  • Alerts at 25, 50, 75 and 90 percent
  • Refresh every five minutes, Cmd+U shortcut

When to use it

Good fit

  • You use Claude in the browser on a Mac and want the weekly bar always visible

Not for

  • People who would rather not copy a session cookie into a third-party app
  • Windows or Linux

How to install ClaudeUsageBar

You need: macOS 12 Monterey or later

  1. Download ClaudeUsageBar-Installer.dmg from the releases page
  2. Drag ClaudeUsageBar to Applications and launch it
  3. Open claude.ai/settings/usage, open developer tools, Network tab, refresh, open the usage request and copy the Cookie header
  4. Paste the cookie in the app

Permissions and security

What it can access

  • Stores your claude.ai session cookie and sends it to claude.ai's internal usage endpoint

Security notes from the maintainers

  • A session cookie grants access to your Claude account; treat it like a password and revoke it by signing out if in doubt

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.

Limitations

  • Depends on internal endpoints that may change without notice

Tools it extends

Frequently asked questions

Does ClaudeUsageBar need my password?

No, but it needs a session cookie copied from claude.ai, which gives the app access to your account until you sign out.

How often does ClaudeUsageBar refresh?

Every five minutes automatically; Cmd+U refreshes on demand.

Can I build ClaudeUsageBar from source?

Yes, with macOS 12 or later and the Xcode Command Line Tools, per the README.

Sources and gaps