Release · 1.0.26

macOS app

Native Swift app. Runs as a menu-bar utility. Requires macOS 14 Sonoma or later on an Apple Silicon Mac.

  1. 1

    Download & open the DMG

    The public macOS DMG is served from GitHub Releases while OpenBurnBar's branded direct-download host is being republished. This link targets the signed, notarized, smoke-tested 1.0.26 GitHub Release asset.

  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.

Available · 0.1.0 · ARM64

Linux desktop app

Available now. Tauri + WebView shell over the native OpenBurnBar daemon. First public release ships aarch64 (ARM64) artifacts only — the AppImage is portable across ARM64 distros, with deb and rpm for Debian/Ubuntu and Fedora/RHEL on the same architecture. Every artifact is Ed25519-signed with a keyless Sigstore/cosign attestation.

Signed prerelease — AppImage, deb, and rpm on GitHub Releases. Hosted on the signed GitHub Release linux-v0.1.0. x86_64 builds are next.

  1. 1

    Install

    AppImage: chmod +x OpenBurnBar_0.1.0_aarch64.AppImage && ./OpenBurnBar_0.1.0_aarch64.AppImage

    deb: sudo apt install ./OpenBurnBar_0.1.0_arm64.deb

    rpm: sudo dnf install ./OpenBurnBar-0.1.0-1.aarch64.rpm

  2. 2

    Daemon & socket

    The app talks to the OpenBurnBar daemon over an AF_UNIX socket. The deb/rpm packages install a systemd unit; AppImage users can start the daemon via the shipped binary or openburnbar-cli service. Install to a trusted path (e.g. /usr/bin) so the daemon's peer-trust check accepts the client.

  3. 3

    Verify the signature (optional)

    Detached Ed25519 signatures ship beside each artifact, plus keyless cosign bundles. Public key: openburnbar-linux-ed25519.pub.pem.

Requirements & notes

Linux

  • aarch64 (ARM64) only for 0.1.0. x86_64 lane is the next release milestone.
  • GTK 3 + WebKit2GTK 4.1 (bundled in the AppImage).
  • Signed with Ed25519 detached signatures and keyless Sigstore/cosign attestation bundles.
  • Tagged as a signed prerelease so it can seed the auto-update chain; the app is fully downloadable and runnable today.
On the App Store

iPhone & iPad companion

Requires iOS 17 or later on iPhone or iPad. Companion to the Mac app — the phone or tablet renders what the Mac records. Native widgets, Live Activity, Siri shortcut.

Get it on the App Store

Free download; BurnBar Cloud subscriptions are available in-app. The iPhone and iPad app renders what your Mac's daemon records — install the macOS app first.

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
  • Current public button uses the GitHub Release DMG fallback
  • Branded direct-download releases are Developer ID signed, notarized, and stapled
  • Direct-download releases publish checksums, SBOM, and Sparkle metadata

Linux

  • aarch64 (ARM64) for v0.1.0
  • AppImage, deb, or rpm from the signed GitHub Release
  • GTK 3 + WebKit2GTK 4.1 (bundled in AppImage)
  • Ed25519 + Sigstore/cosign attestation bundles
  • Daemon AF_UNIX socket; trusted install path for peer auth

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.