Download and install
Mr. Usage requires macOS 13 or later. Download Mr-Usage-macOS.dmg from the project’s GitHub releases, open the disk image, and drag Mr. Usage.app into Applications. Downloads support both Apple Silicon and Intel. Published releases are Developer ID-signed and notarized by Apple; ZIP downloads and SHA-256 checksums are also available on release pages.
Launch the app from Applications and click its usage readout in the menu bar. Mr. Usage is a menu bar companion, so its main interface is the panel anchored to that readout rather than a traditional application window.
Use your existing AI-tool login
Sign in through Claude Code, Codex or OpenCode first. Mr. Usage reuses those existing logins to fetch supported account limits. There is no separate provider login to configure in Mr. Usage, and the app does not refresh provider tokens itself. If a login expires, sign in again using the original tool.
Token activity comes from local tool records and, for OpenAI’s All devices view, daily account history. On a new installation, make at least one request in your AI tool before expecting local token counts. Empty token history does not necessarily mean the account login failed.
Read the Limits and Tokens tabs
Choose Claude or OpenAI in the provider picker. Limits shows available usage windows, reset times and pace markers; OpenAI also shows usage credits when available. Tokens shows activity charts, totals, estimated API cost and a model breakdown. OpenAI offers This Mac and All devices views.
Click a token or cost total to chart it. The gear beside Refresh opens Settings. The app offers Tokyo Night, Catppuccin Mocha and Catppuccin Latte themes. These native-app themes are separate from the website’s light and dark appearance.
Launch at login and keep the app current
After placing the app permanently in Applications, enable Open at Login in Settings if you want tracking available whenever you start your Mac. The download menu includes Check for Updates and automatic-update preferences. Published builds use Sparkle to check for updates; follow Install and Relaunch when a new version is offered.
Source builds require Swift 6 or later. Build instructions, release checksums and the current implementation are available in the public GitHub repository. If a specific feature differs from this guide, check the release notes for the version installed on your Mac.
If usage looks missing or stale
First confirm you have an active login in the original provider tool and recent requests in a supported local tool. Check the timestamp beside the displayed usage: a saved snapshot can be older than live usage. Local logs are scanned every minute, while provider polling follows rate limits and retry delays.
OpenAI account history is daily-aggregated and can lag live usage; today’s account total may be missing. During provider failures, the app preserves the last good result. Manual refresh respects the same polling gates rather than bypassing provider rate limits.
Based on the app’s published documentation. Provider behavior and features can vary by installed version. Read as Markdown.