f-is-h/Usage4Claude

Monitor all your Claude/Codex usage limits in real-time from your macOS menu bar - supports 5-hour, 7-day, extra usage, 7-day Opus and 7-day Sonnet quotas.

Usage4Claude – A macOS menu‑bar app for watching your Claude (and optional Codex) quota

What it is – A native macOS utility written in Swift/SwiftUI that shows, in real time, how much of your Anthropic Claude subscription (Free, Pro, Team, Max) you have used. It can also track OpenAI Codex credits. All data lives locally; the app never sends anything else to a server.

Why you might want it – Claude’s usage limits are split into several buckets (5‑hour, 7‑day, extra usage, per‑model limits such as Opus or Sonnet). Keeping an eye on them helps you avoid surprise cut‑offs, especially when you work across many Claude entry points (web, CLI, desktop, mobile, Cowork agents). The app puts a compact visual indicator in the menu bar, with colour‑coded warnings and optional notifications at 90 % usage or when the quota resets.

Core capabilities (as described in the README)

Real‑time monitoring of all Claude quota types and optional Codex credits.
Smart display mode that automatically chooses which limits to show; you can also manually pick any combination.
Adaptive refresh – a four‑level “smart” system that speeds up polling when you’re actively using Claude and backs off when idle (1 min → 3 min → 5 min → 10 min). A fixed‑interval mode is also available.
Multi‑account support – store several Claude accounts (and multiple organisations per account) and a separate Codex account; switch instantly from the menu.
Customizable UI – choose between percentage‑only, icon‑only, or icon + percentage; pick light, dark, or system appearance; set 12‑/24‑hour time format.
Usage notifications – macOS alerts when you hit 90 % of a limit and when a quota resets.
Built‑in browser login – the app opens an embedded browser, logs you into Claude or ChatGPT, and extracts the required session key / token automatically. For Claude you can also paste the session key manually.
Local‑only storage – credentials are kept in the macOS Keychain; all other configuration lives in local files. No telemetry.
Accessibility – works with any Claude product (web, Claude Code CLI, desktop app, mobile app, Cowork agents) because they share the same quota.
Keyboard shortcuts – ⌘R (refresh), ⌘, (settings), ⌘⇧A (authentication), ⌘U (check updates), ⌘Q (quit).
In‑app updates – powered by Sparkle; the app checks for signed releases, downloads, verifies an EdDSA signature and installs without needing to re‑download the DMG.

Getting started

Install – Download the latest .dmg from the GitHub Releases page, drag the app to Applications, and open it (you may need to allow the unsigned app on first launch).
Alternatively, clone the repo and build with Xcode 15+ on macOS 13+.
Authenticate – On first launch a welcome wizard appears. Click Browser Login for Claude; the app opens a mini‑browser, you sign in, and the session key is captured automatically. (You can also paste a session key manually.)
Configure display – Choose your preferred menu‑bar style, colour scheme, refresh mode, and whether you want Codex monitoring (add a Codex account via ChatGPT login if desired).
Use – The menu‑bar icon now shows a circular progress indicator with colour changes as you consume quota. Click the icon for a detail window that lists each limit, remaining time, and a manual refresh button.
Optional – Enable launch‑at‑login, set usage‑warning notifications, or add more accounts via Settings → Authentication.

Who might benefit?

Developers who use Claude Code or the Claude desktop client and need to stay within their allocated tokens.
Power users who switch between Claude’s web UI, mobile app, and Cowork agents and want a single place to see the combined quota.
Teams on Claude Team/Max plans that need to monitor per‑model usage (Opus, Sonnet, etc.) across multiple members.
Anyone who wants a lightweight, privacy‑first way to avoid unexpected quota exhaustion.

Technical snapshot

Aspect	Detail
Language	Swift 5+
UI	SwiftUI + AppKit hybrid
Architecture	MVVM
Networking	URLSession
Reactivity	Combine
Localization	Built‑in i18n (English, Japanese, Simplified/Traditional Chinese, Korean, French, German, …)
Supported macOS	13.0 (Ventura) and later, Intel & Apple‑Silicon
License	MIT
Distribution	Pre‑built DMG + in‑app Sparkle updates

Roadmap (as of the README)

Core monitoring and UI already complete.
Ongoing work includes polishing the Codex integration, expanding language localisations, and adding any community‑requested features.

Bottom line

Usage4Claude is a focused, open‑source macOS menu‑bar tool that lets you keep an eye on Claude (and optionally Codex) usage without leaving your workflow. It’s built with native Apple technologies, stores credentials securely in the Keychain, and offers a wealth of customisation while staying lightweight (≈20 MB RAM, < 0.1 % CPU when idle).