Repository navigation
v0.1.0 — Lightweight Windows session stats
First public release of Codex Session Stats.
A compact English session bar and expandable panel inside the Windows Codex app. Statistics follow the selected local conversation.
- One native helper: about 11.23 MB working-set memory in local testing (about 84% lower than the earlier Node prototype).
- No Node.js, Python, compiler, or API key required to run this package.
- Total and last-turn tokens, cache hit rate, compactions, status, native context usage, time to first token, and average output speed.
- Green/yellow/red indicators follow Codex's own context occupancy.
- Incremental local log reading, lower-frequency idle checks, and no runtime telemetry.
Run
Download codex-session-stats-v0.1.0-windows-x64.zip, extract it, quit Codex normally for first activation, and double-click Start-SessionStats.cmd. Use Stop-SessionStats.cmd to stop the helper.
Requires the Microsoft Store OpenAI.Codex desktop package; tested on Windows 11 x64. App updates may require compatibility changes. Average output speed includes thinking and tool waits; the memory measurement covers only the helper.
Local validation: 23 native-reader scenarios, 21 UI scenarios, and PowerShell syntax checks passed. See the README for details and the included .sha256 file to verify the ZIP.