Claude Code usage

Usage Meter

macOS menu-bar meter for Claude plan limits (5-hour, weekly, per-model), history, pace and notifications. Nothing leaves your Mac: no data collected, no login held, never online by itself (only a manual update check); it only asks Claude Code.

Install

From source
git clone https://github.com/Echo14091409/usage-meter.git

From the README

Usage Meter

macOS (12 Monterey or later, Apple silicon and Intel), plus an experimental Windows version (below). A menu-bar icon for your Claude plan limits and your Claude Code token use. (Usage meter for OpenAI etc. are under development and will appear soon)

It uses only what Claude Code itself provides on your Mac: no claude.ai cookies, no private web endpoints, no API calls of its own.

Nothing leaves your Mac

- No data is collected. There is no analytics, no telemetry, no crash reporting, no automatic update check and no sync.
- The app never goes online by itself. The one exception is the Check for updates button: only when you press it, the app downloads one public file from this repository on GitHub to read the latest version number. Nothing about you or your usage is sent. You can check with grep -rn "URLSession\|URLRequest" App/: the only matches are in App/Updates.swift.
- It never holds a login. It does not read Claude Code's saved token or any browser cookie. It runs the claude command and reads what that prints.
- The only thing that talks to the internet is Claude Code itself
- Everything the app keeps (readings, history, settings) stays in ~/Library/Application Support/Usage Meter on this Mac.
- Needs Claude Code installed and signed in with a Claude plan; with an API key there are no plan limits.

What it shows

The gauge needle in the menu bar follows the 5-hour figure, with the % beside it while it is fresh.

How it compares with other Claude usage meters (open source and paid): docs/COMPARISON.md.

Screenshots

The whole History window

Install

Needs Xcode or the Command Line Tools (xcode-select --install). No other dependencies. zsh build.sh test runs the tests.

Paste this into Terminal. It downloads this repository into a usage-meter folder,…
Read the full README on GitHub

Details

Language
Swift
Last updated
20 November 2026

FAQ

What is Usage Meter?

macOS menu-bar meter for Claude plan limits (5-hour, weekly, per-model), history, pace and notifications. Nothing leaves your Mac: no data collected, no login held, never online by itself (only a manual update check); it only asks Claude Code. It is a usage for Claude Code, from Echo14091409/usage-meter on GitHub.

How do I install Usage Meter?

Clone Echo14091409/usage-meter from GitHub and follow the setup steps in its README.

Is Usage Meter popular?

Echo14091409/usage-meter has 46 GitHub stars and 0 forks. It was last updated on 20 November 2026.

More usage & cost trackers

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