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.
• Current/session and weekly rate-limit windows, including reset countdowns when Codex exposes reset times.
• Active Codex model and reasoning effort (including Max and Ultra when exposed), plus token and context-window usage.
• 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.
• Collapsible sidebar, toggled from the title or a shortcut.
• Optional auto-show mode while ChatGPT Desktop or a terminal Codex process is active.
• Settings for refresh interval, language, Windows startup, Alt+O show/hide, and Alt+B sidebar shortcuts.

Reset-credit expiration dates come directly from Codex app-server. If the installed Codex version or backend returns only the available count, WindexBar shows that expiration details are unavailable instead of estimating a date.

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.

Requirements

• Codex CLI: WindexBar reads Codex usage through codex app-server, so the codex command must be available on PATH.
• Keep Codex CLI up to date: whenever you update WindexBar to a new release, update Codex CLI to the latest version as well.
• Install Codex CLI: Codex CLI setup

Windows PowerShell:

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

Node/npm:

npm install -g @openai/codex

Bun:

bun install -g @openai/codex

Homebrew:

brew install --cask codex

Other downloads: Codex releases

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
• 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