OpenBurnBar
GitHub Download
Download

Get OpenBurnBar.

macOS is shipping as a public beta. iOS is in Apple review. The editor extension is source-only for now — build locally and load unpacked.

Public beta · 0.1.2-beta.12

macOS app

Native Swift app. Runs as a menu-bar utility. macOS macOS 14 Sonoma or later. Apple Silicon and Intel both supported.

Download DMG · 0.1.2-beta.12
  1. 01

    Download & open the DMG

    Latest beta lives on GitHub Releases. Each release ships signed, notarized, with SHA-256 and SHA-512 checksums next to it.

  2. 02

    Drag OpenBurnBar.app to /Applications

    That's the install. No installer, no admin password.

  3. 03

    Launch & find the menu bar

    OpenBurnBar lives in the menu bar — no Dock icon. Click the flame to open the popover. If Gatekeeper hesitates the first time, right-click → Open.

  4. 04

    Watch the burn

    The app reads logs in ~/.claude/, ~/.codex/, ~/.factory/ and friends. No account, no API keys for local tracking. Quota providers (Cursor, Copilot, Warp, MiniMax, etc.) prompt you per provider when you choose to enable them.

Build from source instead 
git clone https://github.com/Imagine-That-Ai/BurnBar.git
cd BurnBar
make install

Requires Xcode 16+, Swift 5.10+, XcodeGen optional.

In App Store review

iPhone & iPad companion

iOS & iPadOS iOS 17 or later. Companion to the Mac app — the phone or tablet renders what the Mac records. Native widgets, Live Activity, Siri shortcut.

App Store link · pending review

What "in review" means: OpenBurnBar 1.0 is submitted to App Store Connect with manual release enabled — Apple's approval doesn't auto-publish. We'll flip the switch and update this page the moment it's live.

Subscriptions (Hosted Quota Sync) are gated on the same review.

source-only beta

Cursor & VS Code extension

Activity-bar panel that talks to the same local daemon as the menu bar. No public marketplace listing yet — build from source and load unpacked.

  1. 01

    Install & launch OpenBurnBar on macOS

    The daemon must be running — it's how the extension reads data.

  2. 02

    Build the extension

    cd extensions/openburnbar
npm ci
npm run build
  3. 03

    Load unpacked into your editor

    In Cursor or VS Code: Extensions → "Install from VSIX…" or Run Extension from the Run-and-Debug panel pointing at extensions/openburnbar.

  4. 04

    Open the OpenBurnBar activity bar

    The panel surfaces burn for the active workspace and the routed-provider gateway when you have it on.

In development

Android companion

Source under android/. Read-only Firestore consumer today — renders burn data other clients push to Firebase. No Play Store distribution path yet.

Requirements & provenance

What you need, what we ship.

macOS

  • macOS 14 Sonoma or later
  • Apple Silicon or Intel
  • ~120 MB on disk
  • Signed with Developer ID + notarized + stapled
  • SHA-256 / SHA-512 checksums published per release
  • SPDX SBOM per release

iOS / iPadOS

  • iOS 17 or later
  • App Store-installed; subscriptions in-app
  • Hosted Quota Sync requires Firebase sign-in
  • Live Activity needs iOS 16.1+

Editor extension

  • Cursor or VS Code ^1.95.0
  • Node + npm to build
  • Loads unpacked — marketplace listing is roadmap

Two extra resources before you install.

Privacy model Provider matrix GitHub repo