Architecture & Privacy

Under the
Hood

Every component of the Klaude Fuel Gauge - AI Usage menu bar app, annotated — plus a full breakdown of what data stays on your Mac.

How it's built

Klaude Fuel Gauge - AI Usage is a lightweight native macOS app that lives entirely in your menu bar. There are no background services, no helper processes, and no external infrastructure to maintain. The diagram below maps every visible element of the interface to the code component that drives it.

Each section of the exploded view is color-coded to match its role: green for the session tracker, cyan for the weekly budget, amber for usage percentage, purple for quick actions, and blue for settings.

🔧 See how it's built → ▼
Exploded view of the Klaude Fuel Gauge - AI Usage menu bar app, showing each UI component labelled with the Swift code that drives it.
🔍 Zoom 100% ↓
Klaude Fuel Gauge - AI Usage Exploded View · Trace each colored line from the menu bar pill to its component box

Data & Privacy

What goes where

Everything Klaude Fuel Gauge - AI Usage knows about you stays on your Mac. Here's exactly what is stored, what travels over the wire, and what never exists at all.

Stays Local
🔑
In-app session Held in the app's own sandboxed container on your Mac — device-local only, never shared with your browser
📊
Usage percentage cache Unencrypted local app cache; contains figures only — no message content
⚙️
Settings & preferences UserDefaults — plan tier, thresholds, notification preferences
🗑️
Removed on uninstall All stored data is erased when the app is deleted
Goes Over the Wire
📡
Usage API request Read-only call to Anthropic's usage endpoint, authenticated by the session from your in-app sign-in
🔐
In-app sign-in session Created when you sign in through the app's own secure window (a WebView that loads claude.ai). The session lives only in the app's sandboxed container — the app can't read your browser's cookies, and only ever makes read-only usage calls — see the sign-in guide
✉️
Fuel Lock email (optional) Only if you enable Fuel Lock: a lock-attempt notification sent through your own configured mail server, direct to recipients you choose — never routed through us — what is Fuel Lock?
Never Collected
🚫
No personal data sent to us Nothing is transmitted to us or any developer back-end — ever
💬
No message content Klaude Fuel Gauge - AI Usage reads usage counts only — never the content of your Claude conversations
🏗️
No external servers There is no external back-end that stores or processes your data
📢
No analytics or tracking No telemetry, crash reporters, or usage analytics of any kind

Full details in the Privacy Policy.

Klaude Fuel Gauge - AI Usage — Exploded View
Fullscreen exploded view of Klaude Fuel Gauge - AI Usage