elva-labs

Claude Stats — Development skill for Claude Code

Development community

Claude & OpenAI usage quotas in your macOS menu bar.

How to install Claude Stats

This entry records only its repository, not the path inside it, so there is no exact command to give. Open elva-labs/claude-stats and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Stats does

Claude & OpenAI usage quotas in your macOS menu bar.

Alternatives in Development

Cc Bar — Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your me 119 ★
CoderBar — Native macOS agent control for Codex and Claude — monitor, approve, ask, and jump back from the menu bar 100 ★
Claude Status — macOS Menu Bar + Desktop Widget for Claude Code Session Monitoring 59 ★

README

Claude Stats

[![CI](https://github.com/elva-labs/claude-stats/actions/workflows/ci.yml/badge.svg)](https://github.com/elva-labs/claude-stats/actions/workflows/ci.yml) [![Release](https://img.shields.io/github/v/release/elva-labs/claude-stats?display_name=tag)](https://github.com/elva-labs/claude-stats/releases/latest) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) ![macOS 14+](https://img.shields.io/badge/macOS-14%2B-lightgrey)

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.

Claude Stats dropdown showing Claude and OpenAI usage with meters, trend lines and reset countdowns

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