ClaudeSessionView

A macOS menu bar app that shows your real Anthropic account usage — how much of the 5-hour session window and the 7-day weekly window you have burned, and exactly when each one resets.

View releases View on GitHub

Free & open source (MIT) · macOS 26+ · signed & notarized DMG · requires Claude Code

Illustration — the 5-hour session window, live in the menu bar.

Features

📊 Real usage, not an estimate

The 5-hour session and 7-day window percentages come straight from your Anthropic account — the same numbers Claude Desktop shows, never a local reconstruction from your logs.

⏱️ Exact reset countdown

Time remaining until each window resets, plus the clock time it resets at. No more guessing whether it is worth starting one more task.

🎛️ Pick what the menu bar shows

Display the 5-hour percentage, the 7-day percentage, or just the icon. The full detail always stays one click away in the popover.

🔁 Remaining or consumed

Flip every percentage between “remaining” and “consumed” to match how you think. The severity color stays keyed to consumption, so red always means danger.

🌍 Three languages, live

English, French and Chinese, plus System / Light / Dark themes — all switchable on the spot, no relaunch. Liquid Glass UI, native to macOS 26.

🚀 Launch at login

Register the app with your system login items in one toggle, via SMAppService — no helper to install, no Dock icon, nothing left behind when you turn it off.

🚦 Honest error states

If the credentials are missing or expired, or the API rate-limits, the app says so explicitly and keeps the last known values on screen instead of inventing a number.

How it reads real data

It reuses the token Claude Code already stored. When you sign in to Claude Code, it saves an OAuth token in the macOS Keychain. ClaudeSessionView reads that entry — it never asks you for credentials and never stores any of its own.

It asks Anthropic directly. With that token it calls GET https://api.anthropic.com/api/oauth/usage, the endpoint behind the usage figures Claude Code and Claude Desktop show you. That is why the numbers match instead of approximating them.

Read-only, and it stays on your Mac. Nothing is written back, nothing is stored, and no data goes anywhere except to Anthropic's own API. Polling runs every 5 minutes, with exponential backoff if the API rate-limits.

Two deliberate limits. Claude Code must have been signed in at least once on this Mac, otherwise there is no token to read. And the app never refreshes that token itself — Claude Code does that during normal use, so if it has been idle for a long while, run claude once and the app picks the refreshed token back up.

Install

No release has been published yet — the signed & notarized DMG will land on the Releases page when it is ready. Until then, build it from source:

brew install xcodegen        # if you don't have it
git clone https://github.com/vincentlauriat/ClaudeSessionView.git
cd ClaudeSessionView
xcodegen generate
xcodebuild -scheme ClaudeSessionView -configuration Debug CODE_SIGNING_ALLOWED=NO build
open build/Debug/ClaudeSessionView.app

The app lives in the menu bar and has no Dock icon. It needs macOS 26 or later (the UI relies on Liquid Glass APIs that do not exist before that) and Claude Code signed in at least once on the same machine. Architecture notes are in ARCHITECTURE_EN.md.