Setup

Get Floatbar running in minutes.

Pick your platform — one purchase covers both.

WindowsMac
  1. 01

    Download the disk image

    After checkout, click Download for Mac (v1.0.0). Apple Silicon Macs (M1 and newer) use FloatBar-arm64.dmg; Intel Macs use the FloatBar-x64.dmg link. A step-by-step .txt guide downloads alongside the installer. Not sure which chip you have? Apple menu → About This Mac.

  2. 02

    Install

    Open the dmg and drag FloatBar into the Applications folder shown in the window. Eject the disk image afterwards.

  3. 03

    Approve the first launch (one time)

    FloatBar is not yet notarized by Apple, so macOS blocks the first launch of any downloaded copy. Open FloatBar once (macOS will refuse), then go to System Settings → Privacy & Security, scroll down to the "FloatBar was blocked" message, and click Open Anyway. On macOS 13 and older you can instead right-click the app → Open → Open. Terminal alternative: xattr -dr com.apple.quarantine /Applications/FloatBar.app

  4. 04

    First launch

    The floating bar appears at the edge of your screen; FloatBar deliberately has no Dock icon. Press Command + \ to show or hide the bar and Command + Option + Arrow keys to nudge it. Launch-at-login is requested automatically (manage it under System Settings → General → Login Items).

  5. 05

    Connect your AI agents

    Open the dashboard (gear icon on the bar) → Dev Alerts. Click Connect next to Claude Code, Codex, Cursor, Gemini CLI, OpenCode, or Antigravity, then Test connection — a test alert should appear on the bar.

  6. 06

    Optional permissions

    Everything core works without special permissions. Two optional features ask for more: Accessibility lets FloatBar focus your editor and press Approve/Reject for you from alert cards; Automation(prompted automatically) lets it read Terminal or iTerm2 text as a fallback alert source. Grant them in System Settings → Privacy & Security.

  7. 07

    Track credit usage

    Open Credit Usage from the dock to see Codex, Claude Code, and Cursor limits with reset times — same features as the Windows build, from the same codebase.

Requirements for your machine are on the System Requirements page. Stuck? Contact support.