Repository navigation
Releases
v0.2.2 — Reopen ChatGPT from the desktop shortcut
Closing the ChatGPT window can leave the app running in the background. Click the configured desktop shortcut to reopen it without a Session Stats quit prompt. This works with automatic statistics startup on or off.
Upgrading from an earlier version
- Run
Stop-SessionStats.cmdfrom your current installation. ChatGPT can stay open. - Download and extract
codex-session-stats-v0.2.2-windows-x64.zip. - In PowerShell, open the extracted folder and run
.\Install-Shortcuts.ps1 -ConfigureCodexEntry. If you previously chose a custom installation folder, pass the same-InstallDirectory. Your existing startup preference is preserved.
v0.2.1 - Fix ChatGPT startup console window
Fix the black PowerShell window shown when opening ChatGPT through the Session Stats desktop shortcut.
- Use a native Windows GUI launcher that starts PowerShell with no console.
- Include the launcher in portable installs and release ZIPs.
- Upgrade existing PowerShell shortcuts with an exact backup; preserve unrelated shortcuts.
- Preserve automatic-start and other preferences during reinstall unless explicitly changed.
- Recognize Windows short-path aliases when upgrading and reconfiguring shortcuts.
- Add process, shortcut-upgrade, Unicode-path, preference, and extracted-package regression checks to Windows CI.
Upgrade: stop Session Stats with Stop-SessionStats.cmd from your current installation so its executables can be replaced, then extract the ZIP and run Install-Shortcuts.ps1 -ConfigureCodexEntry. Add -InstallDirectory with your current install location if you use a custom directory. ChatGPT can stay open. Your automatic-start choice and other preferences are preserved.
Validation: 23 native reader checks, 21 embedded UI checks, native floating/dashboard integration, launcher regression checks, extracted ZIP installation and SHA-256 verification. GitHub Windows CI passed for commit 7201737: Windows CI.
Download the Windows x64 ZIP and its .sha256 checksum. Release builds do not require Node.js, Python, .NET, or a compiler.
v0.2.0 — Compact floating session stats
Session statistics now fit in a separate, resizable native floating bar. Dashboard controls stay in their own window.
- Shrinks to a 220 × 40 single line; metrics pack with two-space gaps.
- Context used/capacity with an adjacent green/yellow/red indicator from the latest local record.
- Saved dimensions, pinning, 35–100% opacity, and Mini/Compact/Details presets.
- Local usage for relay/API-key providers, with no provider sign-in or app restart needed in floating mode.
- Native desktop shortcut and optional startup through the configured ChatGPT shortcut.
- Updated README with screenshots, usage instructions, and separate memory measurements.
Download the Windows x64 ZIP, extract it, and open Start-SessionStats.cmd. Release builds require no Node.js or Python. Floating mode manually selects a recent conversation; embedded mode follows the active Codex conversation and requires its local debugging interface.
Context colors indicate capacity, not model ability. Output speed includes thinking/tool waits. Local tests passed: 23 reader scenarios, 21 embedded UI scenarios, actual-font layout and warning boundaries, plus native panel and installation checks.
The .sha256 file contains the ZIP checksum.
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.