explaingit

change-42-yhmm/quota-float

Analysis updated 2026-05-18

291RustAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A small always on top desktop widget for Windows and macOS that shows your remaining Codex AI coding quota at a glance.

Mindmap

mindmap
  root((Quota Float))
    What it does
      Shows Codex quota
      Always on top widget
      Local only, privacy first
    Tech stack
      Rust
      Tauri
      React
    Use cases
      Track Codex usage limits
      Avoid hitting quota mid task
      Desktop productivity widget
    Audience
      Codex users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep an eye on remaining Codex quota while coding so you do not get cut off mid task.

USE CASE 2

Get an at a glance warning when Codex usage is close to its 5 hour or weekly limit.

USE CASE 3

See exactly when Codex quota will next reset.

USE CASE 4

Add a supporter skin to personalize the widget's appearance.

What is it built with?

RustTauriReactTypeScript

How does it compare?

change-42-yhmm/quota-floatdeeplethe/forkdthatmagicalcat/txm
Stars291282307
LanguageRustRustRust
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Most users just download a signed installer, building from source needs Node.js 20+, Rust, and Tauri system dependencies.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Quota Float is a small desktop widget for Windows and macOS that shows how much of your Codex AI coding assistant quota you have left. It sits on screen as a compact, always on top window, and it shrinks into a small floating orb when idle, expanding again when you hover over it. The widget shows your Codex plan, your 5 hour usage window, your weekly quota, and when your usage next resets, using clear healthy, caution, and critical states so you can tell at a glance how close you are to a limit. It reads the login state already saved by the Codex Desktop app on your machine and asks the Codex quota service directly for the numbers, rather than guessing usage from local activity, and if that data becomes unavailable or stale it says so instead of making up a number. If the 5 hour window cannot be read, it falls back to showing weekly quota instead. Privacy is treated as a core feature here. The app only reads the existing Codex login to check quota, only sends your existing access token to the quota endpoint, and stores nothing but its own display preferences locally. It does not save your Codex tokens, chat history, prompts, or account details, and it has no analytics, telemetry, or crash reporting built in. Most people should just download a ready made installer from the project's GitHub releases page rather than building it themselves. For anyone who wants to build it from source, it is written with Rust and the Tauri framework for the desktop shell and a web frontend, and needs Node.js 20 or newer plus Rust installed. The standard installer is free and includes the default look, with additional supporter skins available through a locally verified, device bound license that is not sent to any outside service. The project is released under the MIT License.

Copy-paste prompts

Prompt 1
Help me download and install Quota Float for my operating system from GitHub Releases.
Prompt 2
Explain what data Quota Float reads and stores according to its privacy boundary.
Prompt 3
Show me how to build Quota Float from source with Tauri and Rust.
Prompt 4
Walk me through setting up the automated Codex compatibility check for Quota Float.

Frequently asked questions

What is quota-float?

A small always on top desktop widget for Windows and macOS that shows your remaining Codex AI coding quota at a glance.

What language is quota-float written in?

Mainly Rust. The stack also includes Rust, Tauri, React.

What license does quota-float use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is quota-float to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is quota-float for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.