Claude Stats

Claude Stats

[](https://github.com/elva-labs/claude-stats/actions/workflows/ci.yml) [](https://github.com/elva-labs/claude-stats/releases/latest) [](LICENSE) 

A macOS menu bar app that keeps your Claude usage percentages visible at all times — the same numbers `/usage` shows inside Claude Code. If the machine also has a Codex login, your OpenAI quotas ride along.

Features

• Session and weekly percentages in the menu bar, coloured on a continuous green → red scale; a spent quota shows its reset countdown instead of a useless 100%
• Dropdown with meters, trend sparklines, reset countdowns, and a full chart (with burn rate and projected run-out) on click
• OpenAI/Codex quotas alongside Claude when ~/.codex/auth.json exists
• Show in Menu Bar picks which quotas occupy the bar (default: Claude only)
• Adaptive polling: 5–10 min while numbers move, nothing while the screen is off, an immediate fetch when you come back, on-demand fetch when the menu opens
• Read-only credentials: borrows the tokens Claude Code and the Codex CLI already maintain, never touches a refresh token, never prompts for keychain access
• Survives offline: last reading is cached and fades with age instead of vanishing
• No dependencies, no accounts, no telemetry — Foundation and AppKit only

Installation

**Requirements:** macOS 14 or later, and a signed-in [Claude Code](https://claude.com/claude-code) (`claude`) — the app reads its usage through the CLI's login. Codex (`codex login`) is optional an