OpenUsage

Track your AI coding subscriptions from the macOS menu bar — native Swift edition.

OpenUsage shows how much of your AI coding plans you've used: session and weekly limits, credits, and spend, all in one popover. Pin your most important metrics straight into the menu bar.

Features

• Menu bar pins. Pin metrics to the menu bar (up to 2 per provider); render as compact text or mini bars. The strip hides metrics with no data instead of showing placeholders.
• Dashboard popover. Provider-grouped meters with live reset countdowns and pace indicators. Click usage or reset values to flip their display everywhere; right-click a row to hide or star it, refresh its provider, or open Customize.
• Global shortcut. Toggle the popover from anywhere — record any combo in Settings.
• Customize. Turn providers and metrics on or off, choose which rows stay Always Visible or On Demand, and drag-reorder both.
• Stale-while-revalidate. Cached values display instantly at launch; refresh runs every 5 minutes.
• [One-shot CLI](docs/cli.md). Agents can read stable limit JSON through the same five-minute cache with openusage, or bypass freshness with openusage --force; the menu-bar app does not need to be running.
• [Local HTTP API](docs/local-http-api.md). Other apps can read machine-friendly limits from 127.0.0.1:6736/v1/limits; the legacy /v1/usage UI contract remains supported. It is loopback-only and never serves credentials; note that browser pages can read it too — see the [privacy note](docs/local-http-api.md#cors-and-privacy).
• [Proxy support](docs/proxy.md). Route provider requests through SOCKS5 or HTTP(S) via ~/.openusage/config.json.
• Native settings. Launch at login, global shortcut, icon style, theme, density, 12/24-hour time — see [Settings](docs/settings.md).
• [Automatic updates](docs/updates.md). Signed, notarized in-app updates via Sparkle, with an optional beta channel.

Documentation

Behavior docs live in [docs/](docs/README.md): the [dashboard](docs/dashboard.md), [menu bar pins](docs/menu-bar.md), [settings](docs/settings.md), [refresh & caching](docs/refreshing.md), the [CLI](docs/cli.md), the [local HTTP API](docs/local-http-api.md), the [proxy](docs/proxy.md), and one page per provider.

For working on the code, see the developer docs: [architecture](docs/architecture.md), [adding a provider](docs/adding-a-provider.md), and [debugging & capturing logs](docs/debugging.md).