Getting Started
Introduction
What UsageNow is, why it exists, and what it can show you today.
On this page
UsageNow is a native macOS menu bar app for people who build with AI coding tools. It brings reported limits, reset times, and local activity together, without a UsageNow account. Supported providers include Codex, Claude Code, Gemini CLI, Antigravity, Windsurf, Cursor, GitHub Copilot, Perplexity, ElevenLabs, Z.ai, and more.
New in 1.0.0#
- Kazakh / Қазақша, Uzbek / Özbekça and Turkish / Türkçe, bringing the app, widgets and website to thirteen languages. Uzbek uses Ö, Ğ, Ş and Ç.
- Optional first-run setup, with provider choices and deferred permissions. Existing installations retain their settings.
- Flexible notifications: provider-specific thresholds, reset notices and quiet hours, without stale-reading alerts or a morning backlog.
- Optional CLI:
usagenow statusandusagenow status --jsonread the safe snapshot without provider requests or credentials. - Refresh after wake, snapshot compatibility checks, and updated JetBrains AI and Perplexity icons for both appearances.
Also available since 0.9.0#
- Personal widgets, with independent provider and account choices, and a new Large size.
- Quota pace: a local chart and a clearly labelled estimate from fresh quota readings, never token counts.
- Optional service incidents, off by default.
- Antigravity CLI fallback when the IDE cannot answer.
- Experimental JetBrains AI local quota; active-subscription validation remains pending.
- Dutch / Nederlands, bringing the app and website to ten languages, and refreshed Windsurf and ElevenLabs icons.
Why UsageNow exists#
AI coding tools meter usage in windows, such as a 5-hour window and a weekly one. When a window runs out in the middle of a task, you have to wait for it to reset. Each tool reports its limits differently, and checking them usually means switching context: running a command, opening a web page, or waiting for a warning.
UsageNow puts that information in the menu bar, for every tool you use, one click away. See what’s left, and keep building.
Local-first#
UsageNow works from information that already exists on your Mac:
- the official Codex app-server, which comes with Codex
- the session files Codex, Claude Code, Gemini CLI, Kiro, Qoder, Qwen Code, Cline, and Grok Build write as you work
- Warp's and OpenCode's own local databases, and the usage limits Kiro writes to its own log
- the account profile Claude Code keeps in its own configuration
- the Antigravity app's local server, or the official CLI's read-only usage report
- Windsurf's locally cached plan, without reading its sign-in
- JetBrains AI Assistant quota cached by the IDE, without credentials or network access
You don’t need a UsageNow account, and no UsageNow server receives your usage data. Optional connections ask the provider directly with the key, token, or web session you explicitly add; experimental Claude limits use its existing sign-in only if you turn the setting on. See connection privacy.
Privacy
UsageNow never stores or uploads your prompts, source code, or conversations. Privacy explains exactly what is read and where it goes.
Supported providers#
A provider is an AI coding tool UsageNow can report on.
| Provider | Status |
|---|---|
| Codex | Available |
| Claude Code | Available Usage limits are Experimental |
| Gemini CLI | Available Activity only; no usage limits |
| Antigravity | Available IDE limits or compatible official CLI report |
| Kiro | Available Monthly credit limit and today's credits |
| Warp | Available Activity only; no usage limits |
| OpenCode | Available Activity and estimated cost; no usage limits |
| Qoder | Available Credits spent; no usage limits |
| Qwen Code | Available Activity and estimated cost; no usage limits |
| Cline | Available Activity and the cost Cline records; no usage limits |
| Grok Build | Available Activity and the cost xAI reports; no usage limits |
| DeepSeek, Kimi, OpenRouter | Available Balance, with an API key you add |
| Ollama Cloud | Experimental Session and weekly limits, with an API key you add |
| Windsurf | Available Local cached limits |
| Cursor | Experimental Personal plan allowance |
| GitHub Copilot | Experimental Allowances and credit counters |
| Perplexity | Experimental Web credits |
| ElevenLabs | Available Monthly characters, official API |
| Z.ai | Experimental Global Coding Plan quota |
| JetBrains AI | Experimental Local quota; active-subscription validation pending |
What UsageNow can show depends on what each provider exposes. See Providers for details.
Surfaces#
| Surface | Status |
|---|---|
| Menu bar | The main way to use UsageNow: a menu bar item and a popover. |
| Desktop widget | Small, Medium, and Large WidgetKit widgets, with individual provider/account choices. |
| Command-line tool | Coming later. |
Platform#
UsageNow currently focuses on macOS. It requires macOS 15 or later and is built with Swift 6 and SwiftUI, so it looks and behaves like the rest of your Mac — including light and dark appearance.