gitwtfhub

wtf is codexmeter?

mrwancc/codexmeter — explained in plain English

Analysis updated 2026-05-18

35TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A Windows and Mac desktop app that shows your OpenAI Codex usage quota and reset countdown, with an optional tiny hardware display.

Mindmap

mindmap
  root((CodexMeter))
    What it does
      Tracks Codex usage quota
      Shows 5 hour and 7 day limits
      Countdown to reset
    Tech stack
      Electron
      Vue 3
      TypeScript
    Use cases
      Watch quota from a desktop widget
      Push status to a hardware OLED screen
      Avoid checking limits manually
    Audience
      Codex users
      Developers
    Extras
      ESP32-C3 hardware display
      Bluetooth or HTTP push
      Local only storage

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 a pinned desktop widget showing remaining Codex usage without checking manually.

REASON 2

See a countdown to when your 5 hour or 7 day Codex quota resets.

REASON 3

Push live quota status to a small ESP32-C3 OLED screen over Bluetooth or local network.

What's in the stack?

ElectronVue 3TypeScriptViteNaive UI

How it stacks up

mrwancc/codexmeteranandsaini18/deadskillskarminski/codevinci
Stars353535
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/51/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Software version just needs the installer, but the optional hardware display requires flashing an ESP32-C3 board.

You can study the code and use it personally or non-commercially, but commercial use is not allowed.

Wtf does this do

CodexMeter is a desktop app for Windows and macOS that shows how much of your Codex usage quota you have left. Codex is OpenAI's coding assistant, and its usage is capped on both a 5 hour rolling window and a 7 day window. Instead of checking those limits manually, CodexMeter connects through OAuth to read your usage numbers and displays them in a small window on your desktop, along with a countdown to when each limit resets. The app can also be pinned as a small always on top widget so the numbers stay visible while you work in other windows. All authorization data is stored locally on your machine rather than sent to any third party server, and the README is explicit that the app never sends chat content anywhere and never makes model requests of its own. It only reads the usage figures tied to your existing Codex login. Beyond the software version, there is an optional hardware companion built around an ESP32-C3 microcontroller with a small OLED screen. Once flashed through a web based tool, the tiny screen can show the same quota information, pushed to it over Bluetooth or over HTTP on a local network. This is meant for anyone who wants an at a glance physical readout rather than a window on their monitor. Under the hood, CodexMeter is built with Electron, Vue 3, and TypeScript, using Vite for the build, Naive UI for the interface, and electron-store for local data. The project separates its Electron main process, the code exposed safely to the interface, and the actual Vue pages into distinct folders, and it includes automated tests for both logic and UI sizing. The license is a custom non-commercial one: you may study the code, use the app for yourself, and build non-commercial variants of it, but commercial use is not allowed. The maintainer lists a roadmap covering more reliable auto updates, syncing with the hardware display, and support for more quota sources over time.

Yoink these prompts

Prompt 1
Walk me through installing CodexMeter and connecting it to my Codex account with OAuth.
Prompt 2
Explain how CodexMeter's hardware mode works and what parts I need to wire an ESP32-C3 OLED display.
Prompt 3
Help me set up the CodexMeter dev environment and run it from source with npm.
Prompt 4
Summarize CodexMeter's non-commercial license and tell me what I am and am not allowed to build with it.

Frequently asked questions

wtf is codexmeter?

A Windows and Mac desktop app that shows your OpenAI Codex usage quota and reset countdown, with an optional tiny hardware display.

What language is codexmeter written in?

Mainly TypeScript. The stack also includes Electron, Vue 3, TypeScript.

What license does codexmeter use?

You can study the code and use it personally or non-commercially, but commercial use is not allowed.

How hard is codexmeter to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codexmeter for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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