OpenAI builds and deploys advanced AI models like GPT-4o for autonomous agents and workflows.
Codex Usage and Resets
About Codex Usage and Resets
Codex Usage and Resets (CUAR) is a read-only, local plugin for Codex that supplies deterministic facts about current usage pace and reset status. It reads the documented local account/rateLimits/read method to obtain the current Codex usage window and Banked Reset details without consuming usage, triggering resets, or inspecting authentication files. CUAR calculates the delta between current usage and Linear Pace—the theoretical even path that would exhaust weekly usage exactly at the Scheduled Reset—and presents this as a percentage point difference. It also computes a conditional Projected Exhaustion estimate based on the current average burn rate, showing where usage would run out if the pace continues unchanged. The plugin maintains a bounded, sanitized local comparison ledger and preserves source caveats, such as the inability to predict Unscheduled Resets or determine their exact timing. CUAR does not create dashboards, hidden activity streams, or monitoring interrupts; instead, it provides compact planning context within active conversations.
Key features
- Reads current Codex usage window via local App Server method
- Calculates delta from Linear Pace in percentage points
- Computes conditional Projected Exhaustion estimate
- Tracks Banked Reset expirations locally
- Preserves sanitized local usage snapshots for comparison
- Provides planning readouts within Codex conversations
- Supports usage-aware sessions for active tasks
- Observes likely reset signals without scraping external sources
Use cases
- Planning work based on current usage pace relative to Linear Pace
- Making session-level decisions when tasks are likely to consume meaningful usage
- Detecting evidence of Unscheduled Resets by comparing local snapshots
Pros
- Read-only and local, with no telemetry or authentication file access
- Deterministic calculations based on documented Codex methods
- Provides compact, timely planning signals within conversations
- Maintains bounded, sanitized local records for comparison
- Preserves source caveats to avoid overreliance on estimates
Cons
- No hosted service or ability to alter usage limits
- Cannot predict or confirm Unscheduled Resets with certainty
- Relies on documented local methods that may change without notice
- Limited to read-only operations; does not trigger actions or resets
Frequently asked questions about Codex Usage and Resets
What does Codex Usage and Resets (CUAR) actually do?
CUAR is a read-only, local plugin for Codex that supplies deterministic facts about current usage pace and reset status without consuming usage or triggering resets. It reads the documented local account/rateLimits/read method to obtain the current Codex usage window and Banked Reset details.
Who should use CUAR?
CUAR is designed for Codex users who want to maintain awareness of their usage pace and reset timing within their active conversations, particularly those who need planning context without separate dashboards or monitoring interrupts.
Does CUAR send telemetry or inspect authentication files?
No, CUAR does not send telemetry to Filament Labs or inspect Codex authentication files, session logs, private ChatGPT endpoints, or raw App Server responses.
How does CUAR calculate the delta from Linear Pace?
CUAR calculates the delta by comparing current usage with Linear Pace—the theoretical even path that would exhaust weekly usage exactly at the Scheduled Reset—presenting this as a percentage point difference.
Can CUAR predict Unscheduled Resets?
No, CUAR cannot predict or determine the exact timing of Unscheduled Resets; it only provides evidence consistent with a likely reset by comparing local usage observations.
How do I get started with CUAR?
CUAR can be installed from the Plugins View in the Codex App, CLI, or VS Code, and it operates as a local Node.js 18+ runtime without requiring additional setup or configuration.