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:

10(17:00) 20(07.02)

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

Prerequisites

• You must be logged in to Codex (codex login)
• The extension reads authentication from ~/.codex/auth.json

Configuration

• codexLimits.refreshInterval - Refresh interval in seconds (default: 10, min: 5, max: 3600)

Commands

• Codex Limits: Refresh - Manually refresh the rate limit data

How It Works

The extension reads your Codex authentication from ~/.codex/auth.json and makes API requests to get current rate limits from response headers. This ensures you always see up-to-date information.

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