gitwtfhub

wtf is quota-float?

change-42-yhmm/quota-float — explained in plain English

Analysis updated 2026-05-18

291RustAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

See exactly when Codex quota will next reset.

REASON 4

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

What's in the stack?

RustTauriReactTypeScript

How it stacks up

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 spin it up?

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.

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.