WindexBar WindexBar

codex openai system-tray usage-monitor

Use this command to install WindexBar:

winget install --id=myagmb28Dev.WindexBar -e

A small Windows tray app for quickly checking Codex usage and status.

WindexBar

WindexBar is a small Windows tray app for quickly checking Codex usage and status.

Features

System tray status for Codex usage, with a compact always-on-top window.
Account-wide current and weekly rate-limit windows, including reset countdowns when Codex exposes reset times.
Tray alerts when current or weekly usage reaches 80% and 90%, re-armed when Codex reports the next reset window.
Active Codex model and reasoning effort (including Max and Ultra when exposed).
Per-session context-window usage and cumulative token totals, grouped by project.
Observed weekly-limit impact for individual sessions, proportionally attributed by token growth when several sessions are active together.
Background Codex CLI compatibility checks with a 24-hour latest-version cache, automatic updates, an in-app progress gauge, post-update version verification, and an optional manual check button.
Automatic Codex CLI updates through auto-detected or selected PowerShell, npm, Bun, Homebrew, WinGet, or custom commands.
WindexBar update checks on every launch and every 15 minutes while running, with a pinned RSA-signed manifest, SHA-256 verification, an update-now-or-later prompt, silent installation, and automatic restart after approval.
The title bar keeps the product name uncluttered as WindexBar, while the home card shows the current release version.
Live updates for Codex-generated and manually edited session names, with project-free conversations shown under No project.
Banked rate-limit reset credit count with exact expiration details from Codex app-server when provided.
Reset-credit details grouped by exact expiration time, with unavailable expirations shown explicitly.
Remaining ChatGPT credits when Codex exposes the balance.
A bookmark-style sidebar shown beside the left edge of the content card without resizing the main window; title-click and shortcuts pin it, while opt-in hover reveal locks those sidebar toggles.
A dedicated Style sidebar for gauge thickness, a pop-up fill color picker, and animation controls.
Optional auto-show mode while ChatGPT Desktop or a terminal Codex process is active.
Settings for refresh interval, language, Windows startup, rate-limit alerts, optional sidebar hover reveal, Alt+O show/hide, and Alt+B sidebar shortcuts, with hover help and locked-mode notices for conflicting actions.

Install

Download and run WindexBarSetup.exe from the GitHub Releases page.

Source install:

.\install.cmd

Source install launches WindexBar after installation by default. Use .\install.cmd -NoLaunch to install without launching, or .\install.cmd -NoStartup to skip the Windows startup shortcut.

Usage

Run the app, then WindexBar appears as an icon in the system tray.

Left click: open the status window
Right click: open Settings or Quit
Click the title: collapse or expand the sidebar
Open Sessions from the sidebar to inspect per-session usage
Alt+O: hide or show the WindexBar window
Alt+B: collapse or expand the sidebar
Enable Codex auto-show in Settings to show WindexBar only while ChatGPT Desktop or a terminal Codex process is active

Development

SDK: .NET SDK 10.0.301 (global.json)
Local SDK install: dotnet-install scripts
If the local SDK is missing, run.cmd and build-installer.cmd use the system-installed dotnet or the dotnet on PATH.

Run:

.\run.cmd

Test:

dotnet test .\tests\WindexBar.Core.Tests\WindexBar.Core.Tests.csproj -p:NuGetAudit=false

License

MIT. See LICENSE.