Codex Reminder

Tiny always-on-top Windows widget for estimating local Codex activity in the current rolling 5-hour window.

Run

Double-click start_widget.bat, or run:

pythonw codex_reminder_widget.py

Controls

• Drag with left mouse button to move it.
• Hover to show details and the 刷新 / 缩小 / 退出 buttons.
• Double-click to refresh immediately.

What It Shows

• The compact view only shows the risk label and progress bar.
• Hover details show local user messages found in ~/.codex/sessions during the last 5 hours.
• The recovery time is when the oldest counted local message leaves the 5-hour window.
• tok: local thread token activity from ~/.codex/state_5.sqlite.

It does not read auth.json, does not call OpenAI APIs, and does not display or store message contents. Usage from Codex web, iOS, cloud tasks, or another machine is not visible to this local estimate.