Repolode
Submit
robinebers

robinebers/openusage

A macOS menu bar app that tracks usage limits, credits and balances across your AI coding subscriptions in one panel.

View on GitHubWebsite
Stars
4,565
Forks
538
Open issues
73
Last commit
15 hours ago

What is it?

OpenUsage shows how much of each AI plan you have used, including session and weekly limits, credits, and balances. You add each account inside the app, and starred metrics appear directly in the macOS menu bar.

The app supports Claude, ChatGPT, Cursor, Antigravity, Copilot, Grok, Ollama, OpenCode, OpenRouter, and Z.ai. Some providers sign in with OAuth in the browser, while others use API keys. Several accounts for the same provider can be added, and each one gets its own card with usage rows showing reset timing and a pace indicator.

OpenUsage only reads the limits and dollar values reported by each provider's own API. It does not access credentials, logs, or files belonging to other tools. Credentials are stored in the app's own Keychain service. A command-line tool prints the last fetched usage as JSON for scripts.

Key features

  • 01Star up to two metrics per provider to show them in the menu bar.
  • 02Per-account dashboard cards with usage bars, values, and reset times.
  • 03Bar colours indicate whether your pace will run out before the reset.
  • 04Share a PNG screenshot of a provider's usage to the clipboard.
  • 05Optional notifications when a limit drops below 10%.
  • 06Command-line tool that outputs the latest usage as JSON.

Use cases

  • Checking how close you are to the session or weekly limit on Claude or ChatGPT.
  • Monitoring Cursor or Copilot credits while coding throughout the day.
  • Tracking OpenRouter or Z.ai balances alongside your other AI subscriptions.
  • Feeding usage data into scripts or agent workflows via the CLI.

Quick start

  1. 1

    Install OpenUsage with Homebrew

    brew install --cask openusage
  2. 2

    Open the app, then add each account from the Accounts menu and sign in

Things to know

  • Runs only on macOS 15 (Sequoia) or later.
  • Some providers need an API key, and OpenRouter's balance needs a Management key.

In collections

macOS menu bar appsClaude Code tools, skills & pluginsAI coding assistants & agentsOpen-source Mac apps

Topics

#macos#menu-bar#ai-coding#subscription-tracking#usage-monitoring#swift#swiftui#claude#codex#copilot

FAQ

What is openusage?
A macOS menu bar app that tracks usage limits, credits and balances across your AI coding subscriptions in one panel. OpenUsage shows how much of each AI plan you have used, including session and weekly limits, credits, and balances. You add each account inside the app, and starred metrics appear directly in the macOS menu bar.
Is openusage free to use? What license does it have?
openusage is open source under the MIT license. Check the license terms before using it in commercial products.
Is openusage still maintained?
Actively maintained. The last commit to openusage was on Nov 7, 2026.
What can I use openusage for?
Checking how close you are to the session or weekly limit on Claude or ChatGPT. Monitoring Cursor or Copilot credits while coding throughout the day. Tracking OpenRouter or Z.ai balances alongside your other AI subscriptions. Feeding usage data into scripts or agent workflows via the CLI.
How do I install openusage?
Install OpenUsage with Homebrew: brew install --cask openusage Open the app, then add each account from the Accounts menu and sign in
Where can I get openusage?
The source code and installation instructions are on GitHub: https://github.com/robinebers/openusage

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects