Open-source Claude/Codex/Cursor limits tracker for Mac

CreditWatcher, an open-source macOS menu bar app and CLI, now monitors Codex, Claude Code, and Cursor subscription usage limits locally with no telemetry. The tool reads credentials from official tools, caches data locally, and provides a rich terminal dashboard or native menu bar popover. It is designed for privacy-conscious developers who want to track their AI API usage without third-party servers.

A macOS menu bar app and CLI to monitor Codex , Claude Code , and Cursor subscription usage limits — locally, read-only, with no telemetry. Inspired by the design spirit of Stats https://github.com/exelban/stats lightweight macOS menu bar utility . Download CreditWatcher for macOS Prebuilt installers are published through GitHub Releases https://github.com/aalksii/creditwatcher/releases . Three providers — Codex OpenAI , Claude Code Anthropic , Cursor in one place macOS menu bar app — native Swift, no Node.js required at runtime CLI dashboard — rich terminal view with color-coded progress bars Read-only usage checks — never proxies inference or scrapes web UIs Local credentials — reads existing logins from official tools; tokens stay on your machine Shared cache — CLI and menu bar app share ~/.creditwatcher/ quota cache 60-second cooldown — on-demand refresh, avoids hammering provider APIs Optional local web UI — creditwatcher serve on 127.0.0.1 only CreditWatcher is designed to be local-first: | Data | Where it lives | |---|---| | OAuth / session tokens | Read from local files only menu bar app never reads Keychain | | Usage responses | Cached under ~/.creditwatcher/ | | Network calls | Direct to official provider APIs only | No telemetry — no analytics, crash reporters, or third-party servers No token logging — access/refresh tokens are not printed in normal operation No Keychain in the menu bar app — Claude auth uses JSON files and env vars only; no macOS Keychain prompts from the app Optional CLI import — creditwatcher login claude may read Keychain once in Terminal to copy credentials into ~/.creditwatcher/claude-auth.json Sandbox-free macOS app — required to read local credential stores and call provider APIs; see SECURITY.md /aalksii/creditwatcher/blob/main/SECURITY.md CLI: Node.js 18+ macOS app: macOS 14+ Sonoma , Xcode 15+ Provider logins: sign in with official tools first codex login , claude , Cursor.app git clone https://github.com/aalksii/creditwatcher.git cd creditwatcher npm install npm run build npm link optional — install creditwatcher on your PATH Without linking: npm run dashboard rich terminal dashboard all providers npm run status detailed text output per provider npm run quota JSON output used by menu bar integration open macos/CreditWatcher.xcodeproj Product → Run ⌘R Or from the command line: xcodebuild -project macos/CreditWatcher.xcodeproj -scheme CreditWatcher -configuration Debug build The built app is under Xcode DerivedData or build/ when using xcodebuild . For a local drag-to-Applications installer: npm run macos:dmg The DMG is written to dist/macos/CreditWatcher-<version .dmg . For public distribution, sign and notarize it with an Apple Developer ID: SIGN IDENTITY="Developer ID Application: Your Name TEAMID " \ NOTARY PROFILE="notarytool-profile" \ npm run macos:dmg Create the notarytool profile once with xcrun notarytool store-credentials . | Command | Description | |---|---| creditwatcher dashboard | Rich terminal dashboard — all providers | creditwatcher dashboard --force | Skip the 60-second usage cooldown | creditwatcher status codex|claude|cursor | Detailed usage per provider | creditwatcher quota --json | Machine-readable quota JSON | creditwatcher login codex|claude|cursor | Import or OAuth login helpers | creditwatcher serve | Optional local web UI at | Example: creditwatcher dashboard creditwatcher status claude creditwatcher quota --json - Launch CreditWatcher from Xcode ⌘R or open the built .app - A gauge icon appears in the menu bar no Dock icon - Click the icon for a popover with Codex, Claude, and Cursor usage cards - Use the gear button to show/hide providers, reorder cards, and sign in or out per tool - Icon tint reflects worst-case usage: system default <70%, yellow 70–90%, red 90% Refresh: auto-refresh on open; Refresh button bypasses the 60s cooldown. Background refresh every 60 seconds. Quit: click Quit in the popover or right-click the menu bar icon and choose Quit CreditWatcher . Launch at login: System Settings → General → Login Items → add CreditWatcher. CLI button: opens Terminal with creditwatcher dashboard --verbose optional — requires the Node CLI . Sign in with the official tools first. CreditWatcher reads existing credentials — it does not replace them. Recommended: codex login creditwatcher status codex Auth order: ~/.codex/auth.json official Codex CLI ~/.creditwatcher/auth.json via creditwatcher login codex Recommended menu bar app : claude sign in with Claude Code if needed creditwatcher login claude import into ~/.creditwatcher/claude-auth.json Then click Refresh in the menu bar app. Auth order for automatic usage checks freshest token wins on auth failure : CLAUDE CODE OAUTH TOKEN environment variable ~/.claude/.credentials.json ~/.creditwatcher/claude-auth.json import copy via creditwatcher login claude The menu bar app reads only the sources above. For Claude Code installs that store credentials in Keychain no credentials file , run creditwatcher login claude in Terminal — the CLI may read Keychain once there and save a file copy the app can use. Recommended: sign in via Cursor.app, then: creditwatcher status cursor Auth order: CURSOR SESSION TOKEN environment variable- Cursor IDE SQLite state DB — state.vscdb key cursorAuth/accessToken ~/.creditwatcher/cursor-auth.json import copy via creditwatcher login cursor CreditWatcher.app Swift creditwatcher CLI Node.js ├── CodexProvider ├── src/codex/ ├── ClaudeProvider ├── src/claude/ └── CursorProvider └── src/cursor/ │ │ └──────── shared cache ──────────────┘ ~/.creditwatcher/ Native app calls provider APIs directly via URLSession . No Node.js required at runtime. | Variable | Default | Description | |---|---|---| CODEX HOME | ~/.codex | Codex CLI auth directory | CLAUDE CONFIG DIR | ~/.claude | Claude credentials directory | CURSOR SESSION TOKEN | — | Cursor session cookie value | CURSOR STATE DB | platform default | Override path to Cursor state.vscdb | CREDITWATCHER OAUTH PORT | 1455 | OAuth callback port Codex login | CreditWatcher is unofficial and not endorsed by OpenAI, Anthropic, or Cursor. - Usage APIs may change without notice especially Cursor's unofficial endpoints - Third-party tools using consumer OAuth may violate provider Terms of Service - Anthropic has restricted consumer OAuth in third-party tools — use Claude integration at your own risk - This tool performs read-only usage checks — do not use it to proxy inference or share tokens Use at your own risk — the authors are not responsible for account actions by providers See the Safety & Terms of Service safety--terms-of-service section in this README for details on safe usage patterns. - Pre-built macOS release signed .app / Homebrew cask - Demo GIF for README - npm publish for global CLI install Read-only usage endpoints only GET /wham/usage , /api/oauth/usage , /api/usage-summary - Refreshes expired OAuth tokens via official token endpoints when needed - Stores tokens locally only - On-demand checks with a 60-second cooldown per provider - Direct calls to provider APIs — no third-party relay - Proxy inference requests - Scrape ChatGPT or Claude web UIs - Send tokens to any server except the official provider APIs - Background polling beyond the 60s refresh interval - Log or print access/refresh tokens | Pattern | Why it's risky | |---|---| | Spoofing official client harness | Routing subscription quota through third-party agents | | Credential exfiltration | Sending OAuth tokens to third-party servers | | Inference proxying | Using subscription tokens for other users/tools | | Aggressive polling | Hammering usage endpoints | | Token sharing | Distributing refresh tokens across machines | See CONTRIBUTING.md /aalksii/creditwatcher/blob/main/CONTRIBUTING.md . Please report security issues via SECURITY.md /aalksii/creditwatcher/blob/main/SECURITY.md . MIT /aalksii/creditwatcher/blob/main/LICENSE — Copyright c 2026 Aleksei Artemiev