See your Claude Code usage,
without leaving your desktop.

Session, weekly, and per-model limits (Fable, Opus…) — the same numbers as /usage, always visible in the GNOME top bar, the macOS menu bar, or under your Claude Code prompt.

Install → Download release
GNOME 45-50 macOS 13+ MIT read-only
Claude Usage Panel dropdown showing session, weekly and per-model Fable limits

Everything, at a glance

One designed dropdown for every plan limit — plus alerts, trends, and optional Cursor spend.

📊

All plan limits

Session, weekly, and per-model (Fable, Opus…) — one card each, from the official limits[] API.

🎨

Severity colors

Normal / warning / critical, straight from the API — reflected in the top-bar glyph too.

🔔

Limit alerts

A desktop notification the moment a limit first hits 90% or 100%.

📈

Usage sparkline

A tiny per-limit trend graph so you see where you're heading, not just where you are.

💲

Session cost

Optional dollar cost computed locally via ccusage.

🟣

Cursor spend

Optional team cycle spend, today, and top spender via the Cursor Admin API — with a % gauge when a limit is set.

⌨️

Terminal status line

A condensed one-line view right under the Claude Code prompt — same numbers, zero-dependency Node, cache + backoff.

Why this one? Most Claude usage indicators read the endpoint's legacy fields and show only the aggregate session + weekly pair. This one reads the modern limits[] array, so it shows every limit the Claude app shows — including per-model weekly limits the others miss — on both Linux and macOS, with native UI on each. No Electron.

Install

Read-only, private, self-contained. Pick your platform.

GNOME (Linux)
macOS
Claude Code status line
git clone https://github.com/fschmutz/claude-usage-panel.git
cd claude-usage-panel
./install.sh
# then log out and back in (Wayland), and:
gnome-extensions enable claude-usage-panel@fschmutz.github.io

Or grab the .shell-extension.zip from the latest release.

cd macos
swift run          # icon appears in the menu bar
# or ./build-app.sh for a ClaudeUsagePanel.app bundle

macOS 13+. The token is read from the login Keychain — click Always Allow on first launch.

cd claude-code
./install.sh       # merges a statusLine entry into ~/.claude/settings.json

Renders under the Claude Code prompt: Context ▌░░ 8% Session █▌░ 26% 59m Week █▌░ 24% Fable █▊░ 29%. Needs only Node (already present) and a Claude Code login.

Dropdown Settings

How it works

It reads the OAuth token Claude Code already stores locally and calls the official usage endpoint. It never writes your token, and talks only to Anthropic (plus Cursor / ccusage when you enable them).

GET https://api.anthropic.com/api/oauth/usage
    authorization: Bearer <token>
    anthropic-beta: oauth-2025-04-20

The response's limits[] array drives one card per limit — each with a percent, severity, reset time, and optional model scope. On Linux the token lives in ~/.claude/.credentials.json; on macOS, the login Keychain.