BurnTracker 📊
A beautiful, lightweight, and modern macOS menu-bar utility built natively in Swift + SwiftUI. It resides in your macOS menu bar, letting you monitor rolling 5-hour session limits and weekly utilization quotas across multiple Anthropic Claude.ai accounts simultaneously — plus your local Antigravity usage.
Download 📥
Grab the latest signed disk image from the Releases page:
-
Download BurnTracker-<version>.dmg (e.g. BurnTracker-2.2.0.dmg).
-
Open the .dmg and drag BurnTracker into your Applications folder.
-
On first launch, macOS blocks the app — it is signed to run locally rather than notarized with a paid Apple Developer certificate, so Gatekeeper quarantines the download. Clear the flag once:
xattr -dr com.apple.quarantine /Applications/BurnTracker.app
Then open it normally. Prefer not to use the terminal? After the blocked launch, go to System Settings → Privacy & Security, scroll down, and click Open Anyway.
Why not right-click → Open? That bypass was removed in macOS 15 (Sequoia), which is the minimum BurnTracker supports. The warning there is a “BurnTracker” Not Opened dialog offering only Move to Trash or Done, so use one of the two routes above instead.
Requires macOS 15.0 (Sequoia) or newer. Prefer to build it yourself? See Building & Running.
There's also a landing page at https://aminurislam.me/burn-tracker/ with the feature tour and a direct download.
Key Features 🚀
- Native Menu Bar App: A single
MenuBarExtra window that lives in the top status bar with no Dock icon. Clicking the icon toggles the compact widget; a power button in the header quits the app.
- Minimal macOS Aesthetic: Dark-themed cards with responsive status pulsing and native SF typography, matching Apple utility tools.
- Multi-Account Quota Tracking: Add and track multiple Claude accounts (e.g. Personal, Work, Enterprise) with custom labels.
- Antigravity Quotas: Link your local Antigravity app to track real Gemini and Claude/GPT usage buckets (weekly + 5-hour), read locally with no extra login.
- Inline Account Editing: Update a label or rotate an expired
sessionKey directly from the settings list — changing the key automatically re-validates the account against Anthropic.
- Configurable Auto-Refresh: Choose how often quotas sync in the background (every 5, 10, 15, 30, or 60 minutes). Quotas also refresh instantly whenever you open the widget, and whenever your local
~/.claude data changes.
- Usage Alerts: Get a native macOS notification the first time an account's 5-hour session crosses a threshold you pick (50%–95%), or switch alerts Off. Each account alerts once per session window and re-arms automatically after the session resets.
- Live Syncing & Isolation: Connects directly to Anthropic's private web endpoints. Accounts are fetched concurrently; if a key expires or fails, the warning is isolated to that card without affecting other active accounts.
- Start a Session: For an idle account, type a prompt and launch it straight into claude.ai in an embedded browser.
- Privacy First: Your Claude session cookies are stored purely locally under
~/.claude/tracker-settings.json and are transmitted only to Anthropic's endpoints.
- Retina-ready Tray Template: A monochrome status-bar glyph that automatically adapts to light and dark macOS menu bars.
App Interface Preview 📱
How to Get Your sessionKey 🔑
To sync live usage metrics, you'll need the sessionKey cookie value for each account:
- Open your browser and log into claude.ai.
- Right-click on the page and select Inspect to open Developer Tools.
- Head to the Application tab (Chrome/Safari) or the Storage tab (Firefox).
- Expand Cookies in the left sidebar menu and click
https://claude.ai.
- Find the row named
sessionKey and copy its entire value (starting with sk-ant-sid02-...).
- Click the gear icon
[⚙] in the widget header, type a label (e.g. Personal), paste the key, and click Add Account.
Key expired? sessionKey cookies are rotated periodically by Anthropic. When an account shows a Sync Failed warning, open the settings panel, click Edit on that account, and paste a fresh key — there's no need to remove and re-add it.
Building & Running 🛠️
Prerequisites
- macOS 15.0 (Sequoia) or newer
- Xcode 16 or newer
Run from Xcode
Clone the repository, then open the project and run it (⌘R):
open BurnTracker.xcodeproj
The app mounts its monochrome glyph in the status bar. It runs as a menu-bar accessory with no Dock icon; quit it via the power button in the widget header.
Build from the command line
xcodebuild -project BurnTracker.xcodeproj -scheme BurnTracker -configuration Release -destination 'platform=macOS' build
The built BurnTracker.app is placed in Xcode's DerivedData Build/Products/Release/ directory.
Note: the app is ad-hoc signed to run locally, without a paid Apple Developer certificate, so a distributed build is quarantined by Gatekeeper. A build you compile yourself is not — the quarantine flag comes from the browser that downloaded the .dmg, so running straight out of DerivedData needs no extra step. To un-quarantine a downloaded copy: xattr -dr com.apple.quarantine /Applications/BurnTracker.app.
Project Structure 📂
The Xcode project uses a file-system-synchronized group, so any file added under BurnTracker/ is compiled automatically — no project.pbxproj edits needed.
burnTracker/
├── BurnTracker.xcodeproj/ # Xcode project
├── BurnTracker/
│ ├── BurnTrackerApp.swift # @main App: MenuBarExtra + .accessory policy
│ ├── AppState.swift # @MainActor ObservableObject — state + coordination
│ ├── Theme.swift # Color / design tokens
│ ├── Models/ # Account, QuotaData, AntigravityData, TrackerSettings
│ ├── Services/ # ClaudeService, AntigravityService, Persistence,
│ │ # FileWatcher, NotificationManager, SessionAutomation
│ ├── Views/ # RootView, Dashboard, cards, Settings, Components
│ ├── Utilities/ # TimeFormat
│ └── Assets.xcassets/ # AppIcon, template MenuBarIcon, header icon
├── assets/ # Icon sources & preview image
└── README.md
Security & Privacy 🔒
- All requests are initiated directly from your local machine to
claude.ai (and, for Antigravity, your local CLI or Google's Cloud Code API).
- No central server, tracking service, or intermediate proxy is used.
- Keys are saved locally as standard JSON under
~/.claude/tracker-settings.json. Session keys are stored in plaintext on disk — keep them local; they are never logged or sent anywhere except Anthropic.
