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 status and usagenow status --json read 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.

ProviderStatus
CodexAvailable
Claude CodeAvailable Usage limits are Experimental
Gemini CLIAvailable Activity only; no usage limits
AntigravityAvailable IDE limits or compatible official CLI report
KiroAvailable Monthly credit limit and today's credits
WarpAvailable Activity only; no usage limits
OpenCodeAvailable Activity and estimated cost; no usage limits
QoderAvailable Credits spent; no usage limits
Qwen CodeAvailable Activity and estimated cost; no usage limits
ClineAvailable Activity and the cost Cline records; no usage limits
Grok BuildAvailable Activity and the cost xAI reports; no usage limits
DeepSeek, Kimi, OpenRouterAvailable Balance, with an API key you add
Ollama CloudExperimental Session and weekly limits, with an API key you add
WindsurfAvailable Local cached limits
CursorExperimental Personal plan allowance
GitHub CopilotExperimental Allowances and credit counters
PerplexityExperimental Web credits
ElevenLabsAvailable Monthly characters, official API
Z.aiExperimental Global Coding Plan quota
JetBrains AIExperimental Local quota; active-subscription validation pending

What UsageNow can show depends on what each provider exposes. See Providers for details.

Surfaces#

SurfaceStatus
Menu barThe main way to use UsageNow: a menu bar item and a popover.
Desktop widgetSmall, Medium, and Large WidgetKit widgets, with individual provider/account choices.
Command-line toolComing 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.

Next steps#

Suggested

  • Getting Started
  • Claude Code usage limits
  • Reading the menu bar
  • Troubleshooting
  • Privacy