Claude Usage Tracker: a native macOS menu-bar app for Claude limits, profiles and a notch HUD
Native macOS menu bar app for tracking Claude AI usage limits in real-time. Built with Swift/SwiftUI.
At a glance
- What is it?
- Claude Usage Tracker by Hamed Elfayome is a lightweight, MIT-licensed Swift/SwiftUI menu-bar app for macOS that monitors Claude AI usage in real time: the 5-hour session window, weekly limits and per-model use, across unlimited profiles, with a Dynamic Island HUD, terminal statusline and keychain-stored credentials.
- Who is it for?
- Install Claude Usage Tracker if you work on a Mac, run Claude across one or more accounts, and want live limits without opening a dashboard. Download the signed build for macOS 14 or later, add a profile per account for isolated logins and terminal launchers, and turn on the statusline or the Dynamic Island beta if you want the numbers in your terminal or at the notch.
- Can I use it commercially?
- Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
- Is it still maintained?
- Yes. The repository last received commits 16 days ago.
- What is it written in?
- Mainly Swift, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.
DEEP OPEN-SOURCE ANALYSIS
What it is and who it is for
Claude Usage Tracker is a native macOS menu-bar application for real-time monitoring of your Claude AI usage limits, built entirely with Swift and SwiftUI. Its core view tracks the 5-hour session window, weekly usage limits and Opus-specific consumption in a clean popover. It is small, around 6 MB, signed and notarised, and localised into 14 languages.
The people it fits are Mac users who lean on Claude, especially Claude Code, heavily enough to bump into limits and want a glance-able readout. It is deliberately Mac-only and native: several related searches ask for a Windows, Chrome, Firefox or VS Code version, but this project is a macOS menu-bar app, not a browser extension. If you are not on a Mac, it is not for you; if you are, it aims to be the lightweight, always-there usage indicator.
Profiles, terminal launchers and Claude Code integration
The feature that sets it apart from a single-account tracker is multi-profile support: you can manage unlimited Claude accounts with isolated credentials and settings, monitor them all at once in the menu bar, and have the app sync CLI accounts and auto-switch credentials when you change profiles.
Version 3.3.0 added per-profile terminal launchers, which are genuinely useful for anyone running several accounts through Claude Code. The app installs a claude-<profile> command per profile, each opening Claude Code with that profile's own login and its own CLAUDE_CONFIG_DIR, while plain claude follows the active profile. After a single /login, usage tracking for that profile follows automatically. That turns account juggling, normally a chore of logging in and out, into picking the right command, and it means the menu-bar numbers and the CLI you actually run stay in agreement.
The Dynamic Island HUD, statusline and monitoring detail
Two surfaces extend the tracker beyond the menu bar. The Dynamic Island, in beta, is a minimal notch HUD showing what Claude Code is doing in real time: the current tool, session status and a pulse when Claude needs your input. Version 3.3.0 targets the built-in notch specifically. The terminal statusline integrates model, context and profile display, weekly and extra usage segments, pace markers, per-element colours and colour modes, so the same information sits in your prompt.
The monitoring itself is detailed. It tracks session, weekly and per-model usage, naming Fable, Opus, Sonnet and Design, plus API console usage and API costs per profile, and keeps interactive history charts of session, weekly and billing data over time. Smart automation can auto-start sessions, auto-switch profiles and fire threshold notifications. Global shortcuts work system-wide without Accessibility permission, and a headless mode lets it run on Macs accessed over Remote Desktop.
Installing and customizing
Installation is a download rather than a package manager: the README links the latest release as a roughly 6 MB signed and notarised Claude-Usage.zip, and the requirement is macOS 14.0, Sonoma, or later. A Nix installation option was added in v3.1.0 for those who prefer it.
Customization is broad for so small an app: five icon styles, three colour modes (Multi-Color, Greyscale, Single Color), per-element statusline colours, and a toggle between showing remaining and used percentages. The interface detail matters here because the app's whole job is to be readable at a glance in the menu bar, and the options let you make it as loud or as minimal as you want. For developers, the statusline components are the part worth configuring first, since they put usage where you are already looking.
Privacy and multi-provider support
The privacy model is a selling point and is stated plainly: credentials live in the macOS Keychain, storage is local, analytics are minimal and anonymous (a version-only heartbeat), and there is no cloud sync. Moving credentials into the Keychain was a security fix in v3.2.0, referenced by a GHSA advisory, so the current design is the hardened one. For a tool that holds access to your Claude accounts, keeping everything local and in the Keychain is the right posture, and it is worth confirming you are on a recent version to get it.
Despite the name, the app is no longer Claude-only. Version 3.3.0 introduced a multi-provider architecture with OpenAI Codex support, built on a registry pattern documented in docs/ADDING_A_PROVIDER.md so more providers can follow, with provider selection per profile. If you run both Claude and Codex, one menu-bar app can now track both.
Releases, maintenance and limits
The project is actively developed with a large contributor base. Recent releases are v3.3.0 on 2026-08-29, the multi-provider and terminal-launcher release thanking 8 community contributors; v3.2.0 on 2026-07-12, which added the Dynamic Island beta and moved credentials to the Keychain; and v3.1.1 in April. The last push was on 2026-08-31, and the changelog shows steady work on macOS 26 and 27 compatibility, crash fixes and localisation.
The limits are the obvious ones. It is macOS 14+ only and native, so there is no cross-platform or browser build; the Dynamic Island is still beta and depends on hardware with a notch; and the usage figures are only as current as the app can read from your accounts, with past releases noting transient errors on profile switch that later versions fixed. None of that undercuts the core value for a Mac-based Claude user: real-time limits, multiple accounts and local, keychain-backed credentials in a 6 MB app.
Editorial conclusion
Install Claude Usage Tracker if you work on a Mac, run Claude across one or more accounts, and want live limits without opening a dashboard. Download the signed build for macOS 14 or later, add a profile per account for isolated logins and terminal launchers, and turn on the statusline or the Dynamic Island beta if you want the numbers in your terminal or at the notch.
Frequently asked questions
Is there a Windows, Chrome or VS Code version of Claude Usage Tracker?
No. This Claude Usage Tracker is a native macOS menu-bar app built in Swift/SwiftUI and requires macOS 14.0 (Sonoma) or later. The README describes no browser extension, VS Code plugin or Windows build.
Is Claude Usage Tracker safe to use with my accounts?
It is privacy-first: credentials are stored in the macOS Keychain, storage is local, there is no cloud sync, and analytics are a minimal anonymous version-only heartbeat. Moving credentials to the Keychain was a security fix in v3.2.0.
How does it track Claude usage across multiple accounts?
It supports unlimited profiles with isolated credentials, monitors them all in the menu bar, syncs CLI accounts and auto-switches credentials on profile change, and installs a claude-<profile> command per profile so each opens Claude Code with its own login.
Community notes