Codex Limits Monitor

A minimal VSCode extension that displays Codex rate limits in the status bar.

Status Bar Format

The extension shows rate limit information in the format:

96(14:44)! 15(04.07)! [2!]

Format Breakdown

First part: 10(17:00)

• 10 - Usage percentage of the 5-hour session limit (0-100)
• 17:00 - Reset time for the 5-hour limit in HH:MM format

Second part: 20(07.02) or 20(17:00)

• 20 - Usage percentage of the weekly limit (0-100)
• 07.02 - Reset date in DD.MM format (if reset is not today)
• 17:00 - Reset time in HH:MM format (if reset is today)

Warning indicator: !

• If usage percentage exceeds time progress percentage, an exclamation mark ! appears after the closing parenthesis
• Example: 10(17:00)! means usage (10%) is ahead of time progress

Reset credits: [2!]

• [2] means two available limit reset credits
• ! inside brackets means Codex reported a reset-credit burn/expiry date less than seven days away
• If Codex does not report reset credits, the bracket is omitted

Details View

Click the status bar item or run Codex Limits: Show Details to view structured details:

• 5-hour and weekly usage, time progress, and exact reset dates
• Reset-credit count and burn/expiry date when Codex reports them
• Oldest reset first seen, tracked locally by the extension
• Plan, active limit, data sources, and app-server warnings
• Account usage summary when Codex reports it

Prerequisites

• You must be logged in to Codex (codex login)
• The extension reads authentication from ~/.codex/auth.json
• The extension reads the preferred model from ~/.codex/config.toml and falls back to current ChatGPT-account-compatible Codex models if needed
• Reset-credit details are read through codex app-server --stdio

Configuration

• codexLimits.refreshInterval - Refresh interval in seconds (default: 10, min: 5, max: 3600)
• codexLimits.codexCommand - Command used to run Codex app-server (default: codex). If codex is not in VS Code's PATH, the extension tries the bundled Codex CLI from the OpenAI/ChatGPT extension automatically.
• codexLimits.accountRefreshInterval - Account details refresh interval in seconds (default: 60, min: 30)

Commands

• Codex Limits: Refresh - Manually refresh the rate limit data
• Codex Limits: Show Details - Open the structured details view

How It Works

The extension reads your Codex authentication from ~/.codex/auth.json, picks the current model from ~/.codex/config.toml, and makes lightweight API requests to get current rate limits from x-codex-* response headers. It also reads current account details from codex app-server --stdio using read-only methods. It supports both relative reset headers (reset-after-seconds) and absolute reset headers (reset-at).

Acknowledgments

This extension was inspired by:

• codex-ratelimit-vscode by xiangz19
• codex-stats by Maol-1997 - for the API-based approach to getting rate limits

License

MIT