extsvforest

Codex Weekly Usage Indicator — Development skill for Claude Code

Development community

Unofficial Windows always-on-top widget for remaining Codex and Claude usage.

How to install Codex Weekly Usage Indicator

This entry records only its repository, not the path inside it, so there is no exact command to give. Open extsvforest/codex-weekly-usage-indicator and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Codex Weekly Usage Indicator does

Unofficial Windows always-on-top widget for remaining Codex and Claude usage.

Alternatives in Development

Brow — Claude Code usage and rate limits in the MacBook notch 50 ★
Clawd Usage Winwidget — Claude usage limits in a tiny Windows widget + tray icon — with pixel Clawd who reacts to your Claude Code ses 40 ★
Claudetuner — Know when you'll hit your Claude, ChatGPT & Gemini usage limits — live 5h/weekly gauges, reset forecasts, and 34 ★

README

Codex + Claude Usage Indicator

An unofficial Windows widget that stays on top while Codex Desktop is running and shows Codex weekly usage alongside Claude Fable usage.

What it does

Appears while Codex Desktop is running and hides when Codex exits.
Keeps the existing 272 × 64 window and uses one or two fluid panels depending on which providers are available.
Shows only white remaining percentages: Codex is identified by a blue bar and Claude Fable by a terracotta-orange bar.
Expands one successful provider to the full width when the other provider is unavailable.
Shows Codex weekly reset details plus Claude 5-hour, weekly, and Fable reset details in a hover tooltip.
Reads the weekly usage window from the local Codex app-server.
Reads Claude limits through Claude Code's built-in /usage command with a ten-minute in-memory cache.
Keeps one credential-free successful Claude snapshot locally for up to 24 hours so a rate-limited cold start does not blank the panel.
Keeps the last successful Claude value visible during temporary rate limits or service errors and reports the delay in the tooltip.
Refreshes every 60 seconds; double-click to refresh Codex immediately while Claude continues to honor its ten-minute cache.
Supports dragging, copying the current values, toggling always-on-top, and turning the Claude panel on or off from the right-click menu.
Remembers the last dragged position and restores it on the next launch.
Hides while another foreground app is fullscreen, then returns at the saved position.
Uses a per-user Windows scheduled task at sign-in, so the widget runs independently of Codex. A lightweight supervisor restarts the widget after an abnormal exit, waiting one minute (up to 999 retries per supervisor run).

Account management is optional. After you register a Codex account, the widget stores account labels, identities, each account's latest usage snapshot, and Codex login snapshots encrypted with Windows CurrentUser DP