Frequently Asked Questions
Frequently asked questions
18 answers · More in the documentation
Where can I download UsageNow?
From usagenow.com, as a signed and notarized disk image, or from GitHub Releases. You can also build it from source with Xcode.
How do I know the download is genuine?
The app is signed with a Developer ID and notarized by Apple, so macOS checks it when you open it. To check the file itself, run shasum -a 256 on UsageNow-0.2.0.dmg and compare the result with 15b7ce8c26770e9d401df494aa842691b7fb242f04a0849cd3802465a734d4bc.
What do I need to run it?
A Mac with macOS 15 or later — UsageNow runs natively on both Apple silicon and Intel. Install and sign in to Codex or Claude Code, and use it at least once, so there is something to show.
Is UsageNow free and open source?
Yes. It’s free, and the source code is on GitHub under the MIT License.
Do I need an account?
No. UsageNow has no accounts and no server of its own.
Is there a Windows or Linux version?
No. UsageNow is a native macOS app.
Is there a command-line tool?
A CLI is planned. Today UsageNow lives in the menu bar and in desktop widgets.
Does UsageNow upload my prompts?
No. UsageNow never stores or uploads prompts, responses, or conversation content.
Does UsageNow read my source code?
No. From session files it reads only timestamps, identifiers, model names, token counts, and rate limits. Lines with conversation content are skipped.
Does UsageNow modify my Claude Code credentials?
No. UsageNow never refreshes, modifies, or stores your Claude Code credentials.
Does UsageNow read my Codex credentials?
No. Codex’s own app-server signs in with Codex’s credentials; UsageNow only asks it for your rate limits.
Does the app send analytics?
No. Telemetry is off by default and released builds have no endpoint configured, so the app sends nothing. This website counts page views with cookieless, self-hosted analytics.
What does “58% left” mean?
58% of that usage window remains. UsageNow always shows what’s left, never what’s used.
Why don’t token counts match my plan’s usage?
Token and request counts are local activity recorded on this Mac. They include cached input and don’t include other devices, so they don’t necessarily match quota consumption or billing.
Why are Codex and Claude values different?
Providers expose different quota systems and usage windows, so their percentages aren’t directly comparable.
Why does Claude sometimes show “Usage limits unavailable”?
Claude Code doesn’t expose quota through a supported local API, and the optional experimental source may be turned off or may not have a current sign-in. Local activity still appears.
Which tools does UsageNow support?
Codex and Claude Code. Gemini CLI, DeepSeek, and Qwen are planned, with no integration yet.
Will UsageNow support more providers?
Yes, when reliable and privacy-respecting usage data is available.