Claude Code usage

usage

macOS menu bar and Windows tray app showing Claude Code quota, burn rate and cost.

345 stars 66 forksUsage & cost trackers Plugin marketplace Source

Install

Add the plugin marketplace
/plugin marketplace add aqua5230/usage

Run inside Claude Code, then /plugin to pick what to install from it.

Install
brew install --cask aqua5230/usage/usage
From source
git clone https://github.com/aqua5230/usage.git

From the README

usage

Your Claude Code, Codex, Antigravity, Grok CLI, and Muse Code quota, always on screen.

usage puts your 5-hour and weekly limits in the macOS menu bar or Windows system tray, and turns a quota red as it nears its limit. Hitting the limit halfway through a long refactor is a bad way to find out you were running low. Now you see it coming. There's nothing to run and no page to open.

繁體中文 · 简体中文 · English · 日本語 · 한국어  |  Discussions  |  Landing page

Install · Features · Themes · Comparison · Troubleshooting

- Every quota at a glance: Claude Code, Codex, Antigravity, and Muse Code session and weekly limits with reset countdowns, plus Grok CLI's weekly credit.
- Reads what's already on your machine: Claude Code, Codex, Grok CLI, and Muse Code tokens and cost come from local logs. Antigravity quota comes from its own CLI (no model call), or from Google's official endpoint using the sign-in that CLI already stores. Muse quota comes from a small background model call through its own signed-in CLI.
- Warns before tokens go to waste: The Claude Code status line flags a bloating context window and a cold prompt cache. A banner shows Claude or Codex outages.
- Helpers inside Claude Code: A side pane, shorter replies, a progress hand-off for new sessions, and quota-aware planning. All optional.
- Reports and 16 themes: HTML reports of token trends and cost, and 16 panel themes to pick from.

Install

Runs on macOS 12 or newer and Windows 10/11.

macOS (Homebrew, recommended)

brew upgrade --cask usage keeps it current. Prefer a direct download? Get usage.app.zip from the latest release, unzip it, and drag usage.app into Applications.

Windows (portable)

Download usage-windows.zip from the latest release, unzip it, and run usage.exe. No installer is…
Read the full README on GitHub

Details

Repository
aqua5230/usage
Language
Python
License
AGPL-3.0
Last updated
3 November 2026
Topics
ai-toolsanthropiccatppuccinclaudeclaude-codecodexcost-trackingdeveloper-toolslaunchagentmacosmenubaropenai

FAQ

What is usage?

macOS menu bar and Windows tray app showing Claude Code quota, burn rate and cost. It is a usage for Claude Code, from aqua5230/usage on GitHub.

How do I install usage?

Run brew install --cask aqua5230/usage/usage, then follow the setup in the README.

Is usage popular?

aqua5230/usage has 345 GitHub stars and 66 forks. It was last updated on 3 November 2026.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.