Getting Started

AIMeter is a macOS menu bar app that monitors AI quota usage across all your subscriptions in real time. Once installed, it lives in your menu bar and shows live usage for every connected provider — no browser tab needed.

Click the AIMeter icon in your menu bar to open the panel. Each row shows a provider name, a usage bar, and the current percentage consumed. Bars turn orange above 50% and red above 80%.

System requirements

  • macOS 14 Sonoma or later
  • Apple Silicon or Intel (universal binary)

Installation

Download the latest release from the releases page or use the download link on this site.

  1. Download AIMeter-vX.X.X.zip and unzip it.
  2. Drag AIMeter.app to your /Applications folder.
  3. On first launch, right-click the app and choose Open to clear the Gatekeeper warning (required once, since the app is not notarized yet).
  4. AIMeter will appear in your menu bar. Click the icon to open the panel.
First launch: Always right-click → Open instead of double-clicking. macOS Gatekeeper blocks unsigned apps on the first run. After that, normal double-click works.

Auto-update

AIMeter checks for updates automatically via Sparkle. When a new release is published, you'll see an update prompt inside the app. You can also trigger a check from the Settings panel.

Providers

AIMeter tracks quota for 7 providers. Each has its own authentication method. Open the Settings panel (⚙ icon) to connect or disconnect providers.

ProviderAuth typeNotes
ClaudeSession / API keyConnect via claude.ai session token or an Anthropic API key.
GitHub CopilotOAuthSign in with your GitHub account. Requires an active Copilot subscription.
CodexAPI keyPaste your OpenAI API key. Quota is tracked against your Codex usage tier.
GLMAPI keyZhipu AI API key. Quota resets monthly per your plan.
KimiSessionMoonshot AI session-based tracking. Re-authenticate if the session expires.
MiniMaxAPI keyMiniMax API key. Token quota is tracked per model.
OpenrouterAPI keyTracks credit balance and per-request usage across all routed models.

Profiles

Profiles let you manage multiple accounts for the same provider. For example, you might have a personal Claude account and a work Claude Pro account — each with its own quota, tracked separately.

Creating a profile

  1. Open the Settings panel (⚙ icon in the AIMeter popup).
  2. Select a provider and click Add Profile.
  3. Give the profile a name (e.g. work-claude) and enter its credentials.
  4. The new profile appears in the panel alongside existing ones.

Profile storage

Profiles are stored locally in ~/.aimeter/profiles.json. Credentials are kept in the system keychain — never in plain text on disk.

Routing

Routing maps working directories to specific profiles. When Claude Code (or any Claude-based tool) opens a session, AIMeter reads your current directory and automatically routes the session to the matching profile.

This means ~/work can use your Claude Pro account while ~/personal uses your free account — with zero manual switching.

Routing config

Routes are defined in ~/.aimeter/routing.json. The key is a path prefix (supports ~ expansion), and the value is a profile name.

{
  "~/work":     "claude-pro",
  "~/personal": "claude-free",
  "~/oss":      "claude-free"
}

AIMeter matches the longest prefix first. If no prefix matches the current directory, the default profile for that provider is used.

Routing currently applies to Claude only. Support for additional providers is planned.

Privacy

AIMeter is built on a simple principle: your usage data stays on your machine.

  • All quota data is fetched directly from provider APIs and stored locally.
  • No usage statistics, analytics, or telemetry are collected.
  • No account or registration is required to use AIMeter.
  • Credentials are stored in the macOS system keychain, not in files.
  • AIMeter makes network requests only to the provider APIs you have connected.

Local data

All app data lives in ~/.aimeter/:

~/.aimeter/
  profiles.json     # profile names and metadata (no credentials)
  routing.json      # directory → profile routing rules
  cache/            # last-known quota snapshots (used for offline display)

Removing AIMeter

Delete AIMeter.app from /Applications and remove ~/.aimeter/ to fully uninstall. Credentials stored in the keychain can be removed via Keychain Access.appby searching for "AIMeter".