iPhone
"Your AI agents, in your pocket."
- Quota Watch · Pulse · Streams
- Live Activity + Dynamic Island
- Siri shortcut: "What's my burn today?"
v0.1.2-beta.12 macOS public beta iOS in App Store review
Watch your AI agents. Before the bill.
OpenBurnBar is a local-first developer tool that watches the AI coding agents you already use — Claude Code, Codex, Cursor, Copilot, Factory, MiniMax, and more — and gives you a live read on tokens burned, dollars spent, and quota left, across all of them, on your machine.
● No telemetry by default ● No account required ● Reads logs, not your API keys
OpenBurnBar QUOTAS
-
-
- Claude Code
+3 more in Settings
LaHormigaDormida · not en…
MissionNeeds approval
Burn$2,662.51
Tokens15.12B
Questions0
Followups2
MissionPlanned
RuntimeLocal inference
menu-bar popover · live data
11
Providers with real usage data today
3
Honest confidence labels — exact · estimated · unavailable
0
Telemetry, analytics, or crash reports out of the box
∞
Works offline. The whole product, locally.
A developer tool, not a SaaS dashboard.
OpenBurnBar is built for the kind of developer who has three agents open in parallel and only checks the bill at the end of the month. Three things shape every decision in the product.
- 01
Local-first by default.
The canonical store is a local SQLite database, run by a local daemon under your user account. Firebase is an optional replication plane, not the source of truth. The whole product works offline.
How the privacy model works - 02
Honest about confidence.
Every provider row carries one of three labels — exact, estimated, unavailable. We don't pretend to know what the vendor doesn't tell us.
See the full provider matrix - 03
Built for multi-agent reality.
A single daemon owns routing, quota, retrieval, projects, and missions. Every surface — macOS, iOS, iPad, Cursor, VS Code, CLI, widgets, smart displays — speaks to the same daemon. One source of truth, many windows in.
Tour the product
Inside the app
What a calm console looks like.
The macOS app is dense by design. Today's burn, top providers, quota windows that matter, and an on-device assistant that knows your data — one keystroke away.
OpenBurnBar · Dashboard · Today
⌘K●
TODAY · LIVE · TUE 12 MAY
$14.27
WINDOW
TodayWeekMonthAll
SPEND VS BUDGET live
$348.12 / $500
May · 19 days in · pacing $549 / mo TOP MODEL exact
claude-opus-4-7
$5.92 · 11,300 tok · 14 sessions CACHE HITS today
38%
Saved approx $3.18 vs no-cache baseline Spend by provider · last 7 days
stacked area Claude Code Codex Cursor
Quota — next to burn
refresh ⌘R- Claude Code · 5h 68% · 1h 42m
- Codex · primary 41% · 3h 12m
- Cursor · plan 22% · cycle
- Copilot · premium 14% · 7d
Hermes local index
Your Claude Code · 5h window hits 80% at the current rate by 3:47pm. Top draw is opus-4-7 on the ledger-rebuild project.
⮒ throttle opus on rebuild ⮒ switch to sonnet ⮒ snooze
Mockup uses representative data. The real product looks like this and renders your numbers.
The phone, the tablet, the launcher.
The Mac records. The phone and tablet render. Companion apps stream the same daemon data; widgets and Live Activity surface the burn even without opening the app.
iPad
Adaptive split-view · ⌘1–4 · ⌘R · ⌘H
- Chart Studio — 10 Swift Charts kinds + Mermaid
- Trend Atlas insights rotate across 9 rules
- Hermes Realtime Relay (paid tier)
Android
Pulse · burn 1.53B tokens · projected $1,232.36
- Material 3 + Jetpack Compose, edge-to-edge
- Read-only Firestore consumer; Mac streams the data
- 97 Kotlin files, JDK 21, targetSdk 35
- No Play Store distribution path yet
The list of vendors it actually understands.
Eleven providers ship with real usage data today. Eight more are detected at install but don't expose data — so we show "Installed / Not installed" and stop there.
Selected · see Providers for the full matrix
| Provider | Where the data comes from | Cost | Quota | Credential |
|---|---|---|---|---|
 Claude Code Anthropic's CLI agent — reads ~/.claude/projects/**/*.jsonl | Local JSONL + statusline bridge | exact | yes | none (local) |
 Codex (OpenAI CLI) ChatGPT's coding CLI — reads ~/.codex/sessions/rollout-*.jsonl | Local rollout JSONL | exact | yes | none (local) or ~/.codex/auth.json for hosted refresh |
 OpenAI Organization-wide usage from the admin API | /v1/organization/usage/completions | exact | partial | Org admin key (sk-…) |
 GitHub Copilot Per-seat premium-interaction + chat limits | api.github.com/copilot_internal/user | estimated | yes | GitHub OAuth or PAT (read:user) |
 Cursor Plan usage in USD straight from Cursor's web API | cursor.com/api/usage-summary | exact | yes | Workos session token (auto-extracted) |
 Factory (Droid) Plan tier + rolling 5h/7d/30d windows, lane-aware | factory.ai org subscription + local session settings | exact | partial | WorkOS browser session captured by FactoryLoginHelper |
 MiniMax Coding Plan remaining quota per model | minimax.io coding-plan endpoint | exact | yes | Coding Plan key sk-cp-… |
 Warp Request credits, refresh windows, bonus grants | app.warp.dev GraphQL | exact | yes | wk-… API key |
Eight surfaces, one daemon.
Every screen you care about — and a few you didn't expect — talks to the same local daemon. Multi-agent work needs multi-surface visibility.
macOS menu bar app
The home base. Lives in the menu bar, reads local agent logs, surfaces cost, tokens, quota, sessions, and insights.
- LSUIElement — no Dock icon, no windows stealing focus
- Dashboard, providers, models, sessions, projects, streams, search
- Hermes chat panel sits inside the dashboard
- Daily digest, smart insights, quota refresh, daemon-backed control plane
- Optional Firebase sync, optional iCloud session mirror, optional Sentry diagnostics
iOS & iPadOS companion
Quota Watch, Pulse, Streams, Hermes, Chart Studio. The Mac runs the data; the phone/tablet renders it natively.
- Native Swift Charts via Chart Studio — 10 chart kinds plus sandboxed Mermaid
- Trend Atlas insights rotate across 9 rules
- Lock-screen Live Activity, Dynamic Island, Siri shortcut
- Adaptive split-view + sidebar nav on iPad, keyboard shortcuts ⌘1–4, ⌘R, ⌘H
- Hermes Realtime Relay reaches the Mac's local assistant remotely (paid feature)
Cursor & VS Code extension
An activity-bar panel that hooks into the daemon over the local UNIX socket. Build locally and load unpacked — no marketplace listing yet.
- Burn for the active workspace, scoped to the current Cursor agent run
- Quota panel pulled from the same daemon the menu bar reads
- Routed-provider gateway support — Z.ai, MiniMax, Ollama Cloud via Cloudflare tunnel
- Open VSX / VS Marketplace publication is on the roadmap, not shipped
Local daemon
The control plane. A launchd-managed UNIX socket service every surface talks to.
- Auth-token-gated JSON-RPC + HTTP gateway
- Owns provider routing, quota refresh, retrieval, mission control
- JSONL run journal — every agent invocation, every tool call, replayable
- Repairs itself when launched from a stale plist or moved app bundle
Command-line interface
openburnbar — eight commands for scripting, agents, and operators. Same daemon, no extra account.
- health · controller · questions · followups · missions
- mission-approve · simulator-runs · simulator-replay
- Pipes cleanly into git hooks, CI, and other agent scripts
Widgets & Live Activity
Lock-screen quota, Dynamic Island countdown, home-screen cost sparkline. Siri shortcut: "What's my burn today?"
- Hero small, cost sparkline medium, dashboard large
- Live Activity on iOS 16.1+ with top provider + tokens + cost
- App Intents for Spotlight + Siri
Smart displays
One-click "Make display work" — casts a live OpenBurnBar dashboard, with proof of acceptance before marking healthy.
- Google Nest Hub via Cast V2 + Home Assistant blueprints
- ULANZI TC001 via AWTRIX HTTP or stock-firmware simulator
- Per-device QA matrix gates support claims — see docs/SMART_DISPLAY_DEVICE_QA.md
Android companion
Read-only Firestore consumer — renders burn data other clients push to Firebase. Source under android/.
- Material 3 + Jetpack Compose, edge-to-edge
- Full screen set: burn · streams · pulse · providers · hermes · chart studio · smart display · store · you
- No Play Store distribution path yet
Hermes
A messenger for your own data.
Ask, in plain language, what your week looked like. What model burned the most cache. Which window is about to roll over. Hermes pulls context from your local SQLite — your sessions, providers, models, tools — and answers right there, in chat.
- · Conversation Atoms. Every entity Hermes mentions becomes a tappable chip — cost, session, provider, model, window — that opens the matching native view.
- · Chart Studio. On iPhone and iPad, Hermes streams JSON envelopes that render to 10 native Swift Charts kinds and sandboxed Mermaid diagrams.
- · Two backends. Local Index for stateless per-turn answers via the CLI, or the local Hermes Gateway for multi-turn, OpenAI-shaped chat with server-side tool calls.
- · Hermes Remote Relay. Reach the Mac's Hermes from anywhere over an end-to-end-encrypted WebSocket. Paid-tier; relay never sees plaintext.
By default, OpenBurnBar collects nothing.
All processing happens on your device. No telemetry, no analytics, no crash reports — nothing is transmitted unless you explicitly opt in.
- No API keys read for local-only tracking.
- No account required for the core product.
- Optional Firebase sync after sign-in — metadata only by default.
- Optional iCloud mirror uses your Apple ID, separate from OpenBurnBar's servers.
- Hosted credentials, when used, go to Google Cloud Secret Manager — not Firestore.
- Claude Code is self-hosted only, by design.
Watch the burn. Keep building.
OpenBurnBar is MIT-licensed, signed and notarized for macOS, and ready to run today.