Codex Quota Monitor

A VS Code extension that displays your current Codex quota in the status bar.

This version reads quota through the local Codex app-server:

codex app-server --listen stdio://

It sends the JSON-RPC method:

{"method":"account/rateLimits/read"}

So it no longer reads ~/.codex/auth.json or calls backend usage URLs directly.

What it shows

The status bar displays the remaining percentage for:

• primary: usually 5 hours, windowDurationMins = 300
• secondary: usually 7 days, windowDurationMins = 10080

Example:

Codex 5h 99% · 7d 83%

Click the status item or run Codex Quota: Show Details to see reset times and raw JSON.

Windows setup

You need Codex CLI installed and logged in.

where.exe codex
codex --version
codex app-server --help
Test-Path "$env:USERPROFILE\.codex\auth.json"

The extension auto-detects common Windows paths, including:

%USERPROFILE%\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe
%APPDATA%\npm\codex.cmd

If auto-detection fails, set:

{
  "codexQuota.codexExecutablePath": "C:\\Users\\12042\\AppData\\Local\\Programs\\OpenAI\\Codex\\bin\\codex.exe"
}

Settings

• codexQuota.codexExecutablePath: auto by default.
• codexQuota.refreshIntervalSeconds: default 120. Set 0 to disable automatic refresh.
• codexQuota.requestTimeoutSeconds: default 20.
• codexQuota.statusBarIcon: default $(copilot). VS Code status bars only support Codicons; the bundled extension icon is Codex-style.
• codexQuota.showNotificationsOnError: default false.

Commands

• Codex Quota: Refresh
• Codex Quota: Show Details
• Codex Quota: Set Refresh Interval
• Codex Quota: Open Settings
• Codex Quota: Open Usage Page

Development

npm install
npm run compile
code .

Press F5 to run the extension host.

Package

npm run package