Download

Get OpenBurnBar.

macOS ships as a notarized direct download and is submitted to Mac App Store review. iOS is in Apple review. The editor extension is source-only for now — build locally and load unpacked.

Release · 1.0.5

macOS app

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

Download DMG · 1.0.5
  1. 1

    Download & open the DMG

    The latest direct-download release is served from OpenBurnBar's download host. Each one ships Developer ID signed, notarized, stapled, with SHA-256 and SHA-512 checksums, a latest-release feed, and a Sparkle-compatible appcast next to it.

    Release feeds: latest metadata · appcast

  2. 2

    Drag OpenBurnBar.app to /Applications

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

  3. 3

    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. 4

    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 · 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.

App Store subscriptions 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. 1

    Install & launch OpenBurnBar on macOS

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

  2. 2

    Build the extension

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

    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. 4

    Open the OpenBurnBar activity bar

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

Feature-complete · Play Store pending

Android companion

The full iPhone & iPad experience, now on Android — your burn, your sessions, the assistant, and Floo, all built and tested. The one thing left is a Play Store listing; until then, build it from source under android/.

Requirements & provenance

What you need, what we ship.

macOS

  • macOS 14 Sonoma or later
  • Apple Silicon Mac
  • ~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
  • BurnBar Cloud and Cloud Pro require 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.