Add a quota-summary built-in status-line item with reset countdowns
Title: Add a quota-summary built-in status-line item with reset countdowns
Summary
Please consider adding a new built-in TUI status-line item, quota-summary, that renders the 5-hour and weekly quota remaining percentages together with reset countdowns.
Example output:
5h:87%(2h1m) wk:50%(5d22h)
Problem
The existing built-in limit items expose remaining percentages, but not the countdown-to-reset signal.
For users who rely on Codex for scheduling and dispatch decisions, the reset countdown is the important missing piece. Remaining percentage alone is not enough to decide whether it is safe to start a high-throughput or long-running task.
This matters especially for:
- deciding whether to dispatch a coordinated team workflow
- deciding whether to start a long-running debugging/refactor session
- reducing unnecessary context switching to other tools just to inspect reset windows
Proposed Design
Add a new built-in status-line item:
quota-summary
Behavior:
- additive only; do not change existing
five-hour-limitorweekly-limitsemantics - render short-form quota remaining plus reset countdown
- omit unavailable windows instead of rendering placeholders
Suggested format:
5h:87%(2h1m) wk:50%(5d22h)
This keeps the current status-line architecture intact:
- one new built-in item
- one shared formatter for quota-summary display
- existing items remain backward-compatible
Why This Shape
I am not asking for a full custom multi-line HUD or a Claude-style footer clone here.
A single additive built-in item is much lower risk:
- no change to existing item semantics
- small surface area for maintenance
- easy to document and test
- useful immediately for scheduling decisions
Notes on Scope
This proposal intentionally does not require:
- arbitrary custom footer rendering
- multi-line footer layout
- custom progress-bar glyph rendering
Those are larger UI/design questions. This request is specifically about exposing the reset countdown signal in the existing status-line system.
Verification from a Local Prototype
I implemented this locally as an additive quota-summary item in the TUI and verified:
- config/setup picker support
- runtime status-line rendering
- countdown formatting from existing rate-limit reset timestamps
Targeted verification used:
cargo test -p codex-tui --lib quota_summary -- --nocapture
Why It Seems Aligned
The existing status-line system already has:
- a fixed built-in item enum
- rate-limit data in TUI state
- existing 5-hour and weekly limit items
So this seems like a natural additive extension rather than a new subsystem.
If this direction is aligned with the team’s intended solution, I already have a working branch and can provide details or a patch outline in the issue discussion.
6 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
I have a working local prototype of this change if it is directionally aligned with the teams intended solution.
Prototype details:
chrisxthe:xthe/quota-summary-status-line96c854990015758faf189575bfe9ea43f877166cScope of the prototype:
quota-summaryfive-hour-limit/weekly-limitsemantics unchanged5h:87%(2h1m) wk:50%(5d22h)Targeted verification used locally:
cargo test -p codex-tui --lib quota_summary -- --nocaptureI understand the repo only accepts code contributions by invitation. If this approach matches the intended direction, Id be happy to provide more implementation detail or open an invited PR.
This feature hasn't received enough upvotes, so closing.
Requesting this be reopened — the underlying need is still active and there's an OPEN tracking issue for the same area (#18812) that only covers absolute reset timestamps, not the countdown format proposed here.
The countdown form (
5h:87%(2h1m) wk:50%(5d22h)) is consistently what users actually ask for in practice, because it answers the real question "can I start a long task now?" without mental math.cc @etraut-openai — given a working prototype already exists on the author's fork, the incremental cost is low. Could this be folded into #18812 rather than left closed?
"closed as completed"? At least be honest about the degree to which you DGAF. Close it as "won't do" or "we don't care"...
"This feature hasn't received enough upvotes, so closing." is kinda of crazy. Not everyone that uses codex also comes to github to "upvote" relevant issues. Claude has this feature and its a shame to not have it in codex.