Fluxa 2.2.0

A more focused Fluxa

This release rebuilds the menu-bar experience around a shared, adaptive visual system and fixes window focus across macOS.

What's new

• Customize stays in the menu-bar panel. It now transitions in place instead of opening a separate Settings window, so the panel no longer disappears when focus changes.
• The Customize layout is fully usable. The stray toolbar band is gone, content starts at the correct position, and the final System option remains reachable at the bottom of the list.
• Tool windows reliably open in front. Lid Angle, Trackpad Scale, Agent Usage, and Focus setup register their actual NSWindow and become key even when another app has active windows.
• New adaptive design system. Higher-contrast surfaces, borders, semantic colors, icon tiles, buttons, usage meters, and hover states work consistently in light and dark appearances.
• Redesigned hardware tools. Lid Angle and Trackpad Scale now use focused cards, clearer live status, improved typography, and more useful guidance.
• Updated documentation. The README now includes Retina screenshots of the panel, Customize, Lid Angle, and Trackpad Scale.

Installation

Download Fluxa-2.2.0.dmg, open it, and drag Fluxa into Applications.

Fluxa is ad-hoc signed and not notarized. On first launch, right-click Fluxa → Open, or run:

xattr -cr /Applications/Fluxa.app

Full Changelog: v2.1.0...v2.2.0

Fluxa 2.1.0

Two new features, and a new menu bar mark.

📊 Agent Usage

Live Claude and Codex quota percentages in the menu bar, plus usage charts.

• Menu bar strip — each pinned agent's mark and percentage, rendered as one template image that tints itself for light and dark menu bars
• Popover strip — the same readings with severity colors (amber at 75%, red at 90%) and a meter per window
• Charts window — click the strip for live quota meters and a GitHub-style contribution grid of tokens spent per day
• Configurable — pick up to three quota windows and the refresh interval in Customize

Quotas come from each agent's own usage endpoint, using credentials the CLIs already stored. Fluxa never refreshes or rewrites them: both providers rotate the refresh token when it's used, so renewing one here would invalidate the login Claude Code or Codex is holding.

The charts are rebuilt from the agents' session logs, which already hold weeks of exact per-turn token counts — so the grid is populated the first time you open it. Days are bucketed by local calendar day, Claude turns de-duplicated on message.id, and Codex's re-emitted stale snapshots skipped; the totals were verified against independently computed daily figures.

Refresh intervals are derived from what the data can express: a 5-hour session window moves one percentage point every three minutes, so that's the floor rather than an arbitrary round number.

Everything stays local. Fluxa talks to the agents' endpoints and nothing else — no analytics, no telemetry. Token counts and the scan cache live in ~/Library/Application Support/Fluxa/.

⚖️ Trackpad Scale

Weighs small objects on the Force Touch trackpad's strain gauges. Rest a finger on the trackpad — the sensor only reports force under a capacitive touch — then place the object beside it; the scale zeroes itself as the object lands.

⏻ New menu bar mark

A switch icon, shipped as a vector PDF so it stays sharp at any scale factor.

Notes

• The first read of Claude's credentials raises a keychain prompt — choose Always Allow. It returns after every rebuild from source, because macOS ties the grant to the code signature and build.sh signs ad-hoc; CODESIGN_IDENTITY=... ./build.sh with a stable identity makes it stick.
• Fluxa is ad-hoc signed and not notarized: on first launch use right-click → Open, or xattr -cr /Applications/Fluxa.app.

Full Changelog: v2.0.0...v2.1.0

Fluxa 2.0.0

What's new

New quick actions

• Dark Mode — toggle the system appearance (grants an Automation permission prompt on first use)
• Show Hidden Files — reveal dotfiles in Finder
• Auto-hide Dock — show the Dock only on hover
• Bluetooth Audio — connect/disconnect paired AirPods & headphones with one click
• Keep Awake timer — 15 min / 1 h / 4 h with automatic shut-off

Fixes

• App failed to launch from /Applications (SwiftPM resource bundle was missing from the bundle)
• Action list rendered empty on macOS 26 (ScrollView collapse inside the MenuBarExtra window)
• Lid Angle now works on Apple Silicon MacBooks (HID sensor; IORegistry path kept for Intel)
• Done in Customize no longer closes the whole popover

Design

• Refreshed popover: per-action tinted icon tiles (filled when active), native mini switches, cleaner rows and header
• Restyled Customize sheet to match

Install

Download the DMG, drag Fluxa.app into Applications.

⚠️ The app is ad-hoc signed (not notarized): on first launch right-click → Open, or run
xattr -cr /Applications/Fluxa.app if macOS reports the app as damaged.

Fluxa v1.0.0

🚀 Initial Release

A lightweight native macOS menu bar utility with 7 quick system actions.

Features

• Keep Awake — Prevent display sleep with IOKit assertions
• Hide Desktop Icons — Toggle Finder desktop visibility
• Screen Saver — Launch system screensaver instantly
• Screen Clean — Full-screen black overlay for safe screen wiping
• Lock Keyboard — Keyboard interception overlay (ESC to exit)
• Focus Mode — Toggle Do Not Disturb via user-created Shortcuts
• Audio Output — Switch audio devices with hot-plug detection

Requirements

• macOS 14 (Sonoma) or later
• Shortcuts app (pre-installed)

Installation

tar -xzf Fluxa-1.0.0.tar.gz
cp -r Fluxa.app /Applications/

Then launch from Applications or Spotlight search.

Build from Source

git clone https://github.com/zEhmsy/fluxa.git
cd fluxa
./build.sh
cp -r Fluxa.app /Applications/

License

Apache License 2.0 — Free to use, modify, and distribute.

---

Built entirely in Swift + SwiftUI with zero third-party dependencies.