Quota Float

A lightweight Windows/macOS desktop widget that keeps Codex, Claude, and API usage visible at a glance.

• Supports four local-first data sources: Codex/ChatGPT subscription quota, Claude subscription quota, OpenAI API costs, and Claude API costs.
• Shows a subscription's 5-hour and weekly quota with its next reset time, or an API source's current spend as an amount and currency.
• Switches the visible provider from the widget, and can rotate between connected sources automatically.
• Uses provider-specific marks and presentation so Codex, Claude, OpenAI API, and Claude API data stay distinguishable.
• Surfaces a compact live metric in the native status area: a small Windows tray-icon number, or an optional macOS menu-bar readout.
• Uses clear quota states for healthy, caution, and critical remaining usage.
• Collapses into a small floating orb when idle, then expands on hover.
• Indicates whether quota is currently being consumed.
• Includes persistent expansion, always-on-top controls, and localized tray actions.
• Falls back to a clearly marked weekly-quota view when the 5-hour window is unavailable.
• Checks for app updates automatically and supports signed in-app updates on Windows.
• Shows reset credit count and available reset-credit expiration times when the quota service provides them.
• Handles stale data, signed-out sessions, unavailable quota responses, and loading states without fabricating values.

Quota states	Floating orb	Reset credit expiration

Expanded weekly view	Weekly quota orb

The preview uses mock quota data only; it does not contain account, device, or license information.

The Glass skin uses a translucent, frosted treatment; Nexus uses a mechanical, futuristic frame. Both previews use mock data only.

Glass	Nexus

Suggested repository description:

A lightweight Windows/macOS desktop widget for Codex, Claude, OpenAI API, and Claude API usage.

Suggested topics:

codex, quota, tauri, react, rust, desktop-app, windows, macos, productivity

Quota Float reads the existing Codex Desktop login state on your machine and queries Codex/ChatGPT quota endpoints with that session. It does not estimate usage from local token counts and does not redeem reset credits or modify account settings.

Browser preview uses mock data. Real quota reading requires the Tauri desktop app and an existing Codex Desktop login on the same machine.

The current public release is v0.2.12. Download the installer for your platform from GitHub Releases:

• Windows (recommended): Quota.Float_0.2.12_x64-setup.exe
• Windows (MSI): Quota.Float_0.2.12_x64_en-US.msi
• macOS Universal (Apple Silicon and Intel): Quota.Float_0.2.12_universal.dmg

• Displays the selected provider's current metric in the Windows tray icon; when API spend is available it is shown there, otherwise the icon shows the remaining 5-hour quota.
• Adds an optional macOS menu-bar readout with the same selected-provider metric.
• Opens the supporter panel on the first two launches after an upgrade, while preserving existing local licenses and preferences.
• Keeps the widget local-first, with clearer unavailable and stale states instead of estimated quota values.

• Adds Claude subscription, OpenAI API-cost, and Claude API-cost sources alongside Codex/ChatGPT subscription quota.
• Displays API spend as an amount with its currency, lets you switch the displayed provider, and supports automatic multi-source rotation.
• Adds provider-specific visual treatment, plus the Glass frosted and Nexus mechanical skins.
• Extends native status-area support with compact Windows tray numbers and an optional macOS menu-bar readout.

Updater artifacts are signed with the project's Tauri update key. Windows Authenticode signing and macOS notarization are separate platform-signing steps; builds without those certificates may still trigger SmartScreen or Gatekeeper warnings.

Please use GitHub Issues for bugs, compatibility reports, and feature requests:

https://github.com/change-42-yhmm/quota-float/issues

The standard installer includes the free default appearances and can unlock optional supporter skins with a signed, device-bound license. Licenses are verified locally; the app does not send device request codes or license text to a service.

Blur and Computer are optional supporter skins. These previews use mock quota data and do not reveal any account, device, or license information.

Blur	Computer

Quota Float is local-first and intentionally narrow:

• Reads the local Codex Desktop login state only to query Codex quota.
• Sends the existing Codex access token only to ChatGPT quota endpoints.
• Stores only widget preferences in its own app config directory.
• Does not store Codex tokens, account IDs, prompts, chat history, raw quota responses, or local auth paths.
• Does not include telemetry, analytics, crash reporting, or third-party tracking.
• Does not redeem reset credits or modify account settings.

See PRIVACY.md and SECURITY.md for the full boundary.

Codex quota is read from Codex/ChatGPT quota service responses. If the response format changes, the app shows an unavailable or stale state instead of inventing quota values.

Requirements:

• Node.js 20+
• Rust stable
• Tauri 2 system dependencies for your platform

npm install
npm run dev
npm run test
npm run build
npm run tauri dev

After Codex Desktop updates, run the compatibility check:

npm run check:codex

See docs/CODEX-UPDATE-CHECK.md for the automated update-check workflow and optional Task Scheduler setup.

npm run tauri build

On Windows, Tauri may download WiX to create an MSI installer. If WiX download fails, the release executable may still be produced at:

src-tauri/target/release/quota-float.exe

GitHub Actions are configured for:

• CI on push/PR: frontend tests, Rust tests, web build, Tauri build.
• v* tags: Windows and macOS Universal installers, updater signatures, latest.json, and a public GitHub Release.

See docs/GITHUB-RELEASE-CHECKLIST.md before publishing a version for others.

Do not upload local credentials, .codex, .env*, screenshots with personal data, node_modules, dist, src-tauri/target, or local installers to source control.

MIT