Codex Meter

English · Italiano

How much Codex do you have left? Just glance at your desktop.
Remaining quotas, reset times, and local chat activity in a Windows widget.
Choose a compact card or an animated pet that follows your work in Codex.

🚀 Try Codex Meter   ·   Explore the features

_{Widget preview using sample data. Actual limits depend on your Codex account.}

Why use it?

The interface is available in 11 languages. Select Language from the tray menu: the change takes effect immediately and your preference is saved. See the translation documentation (Italian).

When you work with Codex, knowing how much quota remains and when it resets helps you decide whether to keep going or take a break. Codex Meter keeps that information on your desktop, so you can check it at a glance.

Display just the percentage you care about, view three limits together, or work alongside a pet that reacts to activity in your local chats.

✨ Features

Remaining quota at a glance
Percentages show how much you can still use. Click to view all available limits and their reset times: five-hour windows, weekly windows, and reserve quotas when returned by Codex. Refreshes are automatic, with an adjustable interval and a manual refresh command.

Three ways to keep track
Choose Compact, 3 limits, or Pet. Card views offer Mini, Ring, and Monitor styles; pets can show minimal information or a bubble. Adjust scale, opacity, and whether the widget stays on top, then drag it wherever you need it.

A pet that follows your work
Mascots react to thinking, execution, review, waiting for input, completion, and errors or interruptions detected in local logs. Choose from nine included pets — Kira, DarkShrill, Germoglio, Pip, Clippy, Dario, Doraemon, Goku, and Mini Elon — or import your own from a compatible folder or ZIP archive.

Active chats a click away
In Pet view, the counter opens Active tasks, showing the names and states of detected chats. Move the window to another monitor and customize the positions of information and popups for each pet.

On the Windows taskbar, too
Enable the quota monitor on the main taskbar to see percentages and time until reset. The notification area icon lets you show or hide the widget, refresh data, choose a language, and open settings. You can also enable startup with Windows.

Pet activity and the task list depend on local Codex sessions. Cloud-only tasks are not detected; some states or approval requests may not appear in the logs. With multiple chats, the pet follows the most recently active one. The taskbar monitor appears when there is free space.

👀 See it in action

Data refresh	Windows integration
Choose how often quotas refresh.	Keep the monitor where it works best for you.

_{Settings screenshots with sample data. The screenshots show the Italian interface.}

_{DarkShrill, Mini Elon, and Dario in action: real widget components and animations, with a simulated desktop, activity, and quotas.}

🧪 What's next?

Claude Code support?

Using Claude Code too?

I'm considering adding Claude Code support to Codex Meter.

👍 Vote for Claude Code support →

React to the issue with 👍 or leave a comment telling me what you'd like to see supported.

🚀 Installation

You need Windows 10/11 and Codex CLI already installed and authenticated. Codex Meter uses the sign-in configured in Codex; you do not need to enter credentials in the app.

Public download: this copy of the project does not include a GitHub repository URL, installer, or complete Windows package. There is therefore no verifiable link to the latest release. Executables in the build folders are local builds.

If you have received a complete Windows app folder, open it and launch CodexMeter.exe, keeping all supplied files together. You do not need to install Qt separately if the required dependencies are included in the package.

If you only have the source code, see Development for build instructions.

Codex not found?

1. Install Codex CLI

Codex Meter requires Codex CLI to be installed and authenticated.

On Windows, you can install the latest Codex CLI directly from PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Check from PowerShell:

```powershell
where.exe codex
codex --version
codex app-server --help

If you have just installed Codex, restart Codex Meter to refresh PATH. The app also checks the Windows locations defined in the code. To specify an executable explicitly, set CODEX_CLI_PATH to the path of codex.exe before launching the app.

🎯 How it works

1. Launch Codex Meter. The app starts codex app-server and reads the limits of the authenticated account.
2. Choose your widget. Open settings from the gear button or notification area icon, then select Compact, 3 limits, or Pet. Choose your preferred language from the tray menu.
3. Place it on your desktop. Drag it to the desired position and adjust scale, opacity, and whether it stays on top.
4. Keep working. Quotas refresh automatically. Click the widget for details and, in Pet view, click the counter to see active tasks.

💡 Why it exists

Reaching a limit in the middle of your work breaks your rhythm. Seeing the remaining quota and next reset ahead of time makes planning easier. Codex Meter was built to keep this information visible alongside your work; Pet view also gives you a visual signal of local activity.

🎨 Create and add your own pet

Turn your character into a widget: prepare transparent PNGs for the six sequences idle, running, review, waiting, jumping, and failed, then describe them in frames-manifest.json using the codexmeter-16-pose-extension schema.

1. Draw the poses. Use a consistent canvas, for example 192 × 208 px. Each sequence needs at least one frame; add more to animate it. Sixteen frames are not required.
2. Prepare the package. Organize the PNGs in frames/<state>/ and use the example manifest, renamed to frames-manifest.json. The frames lists define playback order; durations specifies milliseconds per frame, with a default of 125 ms.
3. Import it. Under Settings → Appearance → Pet → Pet / expression, press + and select the complete folder or ZIP archive. The pet is added to the library and selected.
4. Try it. Enable Animate pet, check its gestures with Test animations, and arrange its elements with State and positions.

Read the full guide (Italian): folders, JSON format, animations, and importing →

🛠️ Technology

C++17 · Qt 6 · Qt Quick / QML · qmake. The interface uses Qt Quick Controls 2 and Poppins fonts, with native Windows APIs for system integration. Limits come from codex app-server over JSON-RPC; activity is read from sessions in CODEX_HOME/sessions or ~/.codex/sessions. The app does not read or store OpenAI credentials directly.

🧑‍💻 Development

Install a Qt 6 kit for Windows with Core, Gui, Widgets, Qml, Quick, and QuickControls2, plus its matching compiler. The existing local build uses Qt 6.9.0 with 64-bit MinGW; the project does not specify a more precise minimum version than Qt 6.

Open CodexMeter.pro in Qt Creator, select the kit, and use Build / Run. To build from a command prompt configured for Qt and MinGW, start at the project root:

mkdir build\README-Release
cd build\README-Release
qmake ..\..\CodexMeter.pro CONFIG+=release
mingw32-make
release\CodexMeter.exe

With an MSVC kit, use the Qt/MSVC command prompt and replace mingw32-make with nmake. Reading real quotas also requires an authenticated Codex CLI.

Previews and tests

Debug builds include a QML gallery with sample data:

debug\CodexMeter.exe --preview
debug\CodexMeter.exe --preview SettingsPreview.qml

Preview files are in qml/previews. C++ tests use Qt Test in activity-tests.pro, taskbar-tests.pro, pet-package-tests.pro, and localization-tests.pro. QML tests are in tests and use Qt Quick Test. To update screenshots from the current components, follow the capture procedure (Italian).

Credits and asset licenses

Poppins includes the SIL Open Font License. The Clippy atlas reference already documented in the project is the codex-clippy script.

This copy does not include a general project license; the font license applies to the font itself.

❤️ Support the project

If Codex Meter helps you:

⭐ Star the repository to help other developers discover it.

🟠 Using Claude Code too?
Vote for Claude Code support →

Found a bug or have an idea? Open an issue — feedback is welcome.