v0.4.5

Codex Runtime HUD v0.4.5

Fixed

• Fixed the 5h quota disappearing and the weekly quota appearing frozen when the selected task starts emitting another limit family such as base_model_inference / gpt-reserve.
• Source the standard Codex 5h and weekly windows from the newest account-wide observations across eligible local root rollouts instead of tying them to the task displayed in the HUD.
• Keep the two standard windows independent, so a newer weekly-only snapshot cannot erase the latest 5h observation.
• Include newer quota snapshots from archived root rollouts without adding archived tasks to the picker while current sessions exist.
• Show live account quotas even when no eligible local rollout is available.
• Correct current-turn token totals when the first turn contains multiple cumulative usage snapshots, and keep exact response usage visible in the session view until the next cumulative snapshot arrives.
• Update the active turn's model label when Codex applies new settings or reroutes the model.
• Show the localized error dialog when a configured global shortcut is already occupied.

Added

• Added an opt-in High-accuracy quotas (Codex online) source. It reads the standard account bucket through the installed local Codex App Server every 10 seconds and reacts to quota update notifications.
• Kept rollout aggregation as the default and as an automatic per-window fallback when the optional source is unavailable or incomplete.
• The HUD never reads Codex credentials; the complete owned App Server process tree is stopped when the option is disabled or the HUD exits, including installations launched through codex.cmd.

Validation

• All 40 unit tests pass, including regressions for mixed rate-limit families, current and archived cross-rollout aggregation, App Server camelCase fields, multi-bucket selection, per-window fallback, token accounting, model reroutes, shortcut conflicts and Windows process-tree shutdown.
• The Windows single-file EXE builds successfully, contains both overlay_ui and app_server_quota, and passes the packaged CLI smoke test.
• Replayed the reported 01a07014 task while another root rollout contained the latest standard Codex allowance; the HUD resolved both current windows even though the selected task only contained a weekly gpt-reserve snapshot.
• Compared a live App Server read with the Codex app's account usage result; both selected the same standard 5h/weekly windows and reset timestamps.

Codex Runtime HUD v0.4.4

Codex Runtime HUD v0.4.4

Fixed

• Fixed Cache, In, Out, Speed, and Reasoning showing — / 0 / 0 / — / 0 after a long-lived rollout resumes with a lower non-zero cumulative token counter.
• Convert raw total_token_usage snapshots into a logical monotonic total across accounting resets instead of permanently rejecting every later snapshot below the historical maximum.
• Keep an all-zero synthetic/fill token_count snapshot in the pending state rather than presenting it as real zero-token usage.

Validation

• Added regressions for a non-zero cumulative reset and a zero fill snapshot.
• Replayed the reported multi-day MyBlog rollout: the affected turn now resolves to Input 1,375,603, Cached 1,261,440, Output 7,063, and Cache hit 91.7%, while preserving its 24 Steps and timing metrics.

v0.4.3

Codex Runtime HUD v0.4.3

Changes

• Added Hide window to the HUD's native right-click menu.
• Added a persistent global Show/Hide shortcut that works while another application has focus and while the HUD is hidden.
• Added shortcut selectors to both the HUD context menu and the tray menu:
  • Ctrl+Alt+H (default)
  • Ctrl+Shift+H
  • Alt+Shift+H
  • Disabled
• If Windows reports that a shortcut is already registered, the HUD keeps the previous setting and shows a conflict message.
• Added 5h and Weekly remaining-allowance bars with reset countdowns to the expanded HUD. They use the latest local rollout rate_limits snapshot and do not make an API request.
• Identify quota windows by window_minutes, because Codex may expose Weekly as primary when the 5h window is absent.
• Increased the minimum expanded height to keep quota data readable without crowding the runtime metrics.
• Corrected the embedded Windows numeric file/product version to match 0.4.3.

Privacy

The shortcut implementation uses the local Windows RegisterHotKey API. It does not install a keyboard hook, record keystrokes, or add network access. The selected shortcut is stored in %LOCALAPPDATA%\CodexRuntimeHUD\settings.json.

v0.4.2

Codex Runtime HUD v0.4.2

Highlights

• Added drag-resizing from the lower-right corner of the borderless HUD.
• Expanded layout redistributes headline metrics, runtime rows and the context bar as the window changes size.
• Compact layout adapts between vertical and horizontal metric arrangements based on available width and height.
• Compact and expanded dimensions are persisted independently.

Privacy

The application remains local-only: it reads local Codex session JSONL in read-only mode, does not read auth.json, API keys or .env, and does not make network requests at runtime.

Unofficial / Not affiliated with OpenAI. The Windows EXE is unsigned and may trigger SmartScreen on first launch.

Assets

• CodexRuntimeHUD-v0.4.2-windows-x64.exe
• SHA256SUMS.txt
• codex-runtime-hud-demo.gif

Codex Runtime HUD v0.4.1

Codex Runtime HUD v0.4.1

This patch release finalizes the session-picker interaction behavior.

Fixed

• Clicking any area outside the session list now closes the picker consistently, including visible HUD areas and other applications.
• Removed the optional close-on-outside-click setting; this behavior is now always enabled.
• Preserved mouse-release selection handling so selecting a session does not reopen the picker.

Privacy

Unofficial / Not affiliated with OpenAI. The HUD reads local rollout JSONL files only.
It does not read auth.json, API keys or .env, and makes no runtime network requests.

Assets

• CodexRuntimeHUD-v0.4.1-windows-x64.exe
• SHA256SUMS.txt

Codex Runtime HUD v0.4.0

Codex Runtime HUD v0.4.0

Local multi-session monitoring for concurrent Codex work.

Highlights

• HUD session picker with Auto follow and Manual locking.
• Stable root-thread selection that excludes subagent and memory-consolidation rollouts.
• Session priority is now Active > Running (waiting for update) > Idle.
• Fixed picker click event propagation that could reopen the session list after selecting a session.
• DPI-aware Windows rendering and updated session status colors.

Privacy

Unofficial / Not affiliated with OpenAI. The app reads local rollout JSONL files only. It does not read auth.json, API keys or .env, and makes no runtime network requests.

This release is an unsigned Windows x64 single-file executable. Windows SmartScreen may show a warning on first run.

v0.3.4

Codex Runtime HUD v0.3.4

This patch release fixes compact/expanded window positioning at screen edges.

Fixed

• Remember the compact HUD anchor before expanding.
• Restore the original compact position after collapsing, even when the expanded layout was clamped left because the HUD was near the right edge.
• Keep compact position memory independent from temporary expanded-layout movement.

The release remains an unofficial Windows x64 desktop overlay: Unofficial / Not affiliated with OpenAI. It only reads local Codex session JSONL files in read-only mode, does not read auth.json, API keys or .env, and does not connect to the network at runtime.

Assets

CodexRuntimeHUD-v0.3.4-windows-x64.exe
SHA256SUMS.txt

v0.3.3

Codex Runtime HUD v0.3.3

Faster startup

The first HUD paint is no longer blocked by the initial rollout-tree scan; session discovery starts as soon as Tk enters its event loop.
The Windows single-file build keeps only the Windows pystray backend and excludes the unused NumPy dependency, reducing the local EXE from roughly 31.8 MB to 20.7 MB and shortening extraction work at launch.
Metrics, privacy boundaries and rollout parsing remain unchanged.
This is Unofficial / Not affiliated with OpenAI software. It only reads local Codex session JSONL files in read-only mode, never reads auth.json, API keys or .env, and makes no network requests while running.

Windows assets

CodexRuntimeHUD-v0.3.3-windows-x64.exe
SHA256SUMS.txt
The executable is not code signed; Windows SmartScreen may show a first-run warning.

v0.3.2

Codex Runtime HUD v0.3.2

Compact HUD layout

• Changed compact mode to a vertical stack for Cache, In and Out so the
  single-turn counters remain readable in a narrow floating window.
• Moved the Current / Session scope switch to the compact window's upper-right
  corner.
• Refreshed the real-window demo GIF to show the compact and expanded layouts.

This is Unofficial / Not affiliated with OpenAI software. It only reads
local Codex session JSONL files in read-only mode, never reads auth.json, API
keys or .env, and makes no network requests while running.

Windows assets

• CodexRuntimeHUD-v0.3.2-windows-x64.exe
• SHA256SUMS.txt
• codex-runtime-hud-demo.gif

The executable is not code signed; Windows SmartScreen may show a first-run
warning.

v0.3.1

Codex Token Overlay v0.3.1

Root-thread selection fix

• Fixed startup selection for large Codex rollout files. The previous
  head/tail metadata sample could miss a newer task_started in the middle of
  a long file and show the previous session's unchanged metrics.
• Added a cached incremental metadata reader: the first scan reads only
  lightweight session metadata and later refreshes process appended bytes.
• Handles appended lines, unterminated final lines, file replacement and
  truncation without retaining rollout contents.
• Added regression tests for a large rollout with a middle task_started and
  for appended turn metadata.

This is Unofficial / Not affiliated with OpenAI software. It only reads
local Codex session JSONL files in read-only mode, never reads auth.json, API
keys or .env, and makes no network requests while running.

Windows assets

• CodexTokenOverlay-v0.3.1-windows-x64.exe
• SHA256SUMS.txt

The executable is not code signed; Windows SmartScreen may show a first-run
warning.