Under the Hood — How Klaude Fuel Gauge

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 → ▼

🔍 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

🔑

Session auth keys Stored in macOS Keychain — encrypted, device-local only

📊

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 using your existing session cookies

🍪

Session cookies The same cookies your browser already uses when logged into claude.ai — Klaude Fuel Gauge - AI Usage © reads them, never writes new ones

Never Collected

🚫

No personal data sent to us Nothing is transmitted to us or any third party

💬

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.

Built with

Klaude Fuel Gauge - AI Usage © is a fully native macOS application. Every framework listed below ships with the OS or is distributed via the Mac App Store — no web views, no Electron, no third-party runtimes.

SwiftUI MenuBarExtra Combine Network framework macOS Keychain UserDefaults UserNotifications App Sandbox Foundation Security WebKit AppKit