Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>Quota Monitor for CodexNew to Visual Studio Code? Get it now.
Quota Monitor for Codex

Quota Monitor for Codex

Richard Beech

| (0) | Free
Show Codex quota usage in the VS Code status bar.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Quota Monitor for Codex

Quota Monitor for Codex

Show Codex quota usage in the VS Code status bar.

Install

Requires VS Code 1.74.0 or newer. Install Quota Monitor for Codex from the Visual Studio Marketplace: search for it in the Extensions view, or run

code --install-extension RichardBeech.quota-monitor-codex

To install from a file instead, download quota-monitor-codex-0.10.1.vsix from the EVILE project page and choose Extensions → … → Install from VSIX…, or run code --install-extension quota-monitor-codex-0.10.1.vsix.

If you installed a VSIX before version 0.10.1, uninstall it first: earlier builds used a different publisher ID, so VS Code treats them as a separate extension.

What it does

On activation (and on a timer), the extension:

  1. Starts the official local codex app-server process over stdio.
  2. Performs the JSON-RPC handshake (initialize → initialized).
  3. Calls the read-only account/rateLimits/read method.
  4. Renders the remaining percentages in the status bar.
  5. Terminates the app-server process.

Only the focused VS Code window polls; other windows catch up when they regain focus. Clicking the status bar item refreshes immediately. Double-clicking it opens the Codex usage dashboard (chatgpt.com/settings/usage) in your browser; the same page is available via Codex Quota: Open Usage Page.

Banked rate-limit resets (granted by referrals or promotions) show as a line in the hover tooltip when the account has any; they are deliberately kept off the status bar. Purchased ChatGPT credits are not exposed by the local Codex app-server, so this extension cannot show them; they are listed on the usage dashboard.

Status bar colors

The background color reflects the most constrained window (the lowest remaining percentage across the shown windows), using the thresholds from codexQuota.thresholds (defaults shown):

Lowest remaining Appearance
below redBelowPercent (10) dark red background tint
below amberBelowPercent (30) amber background tint
at or above amberBelowPercent green text

Example of moving the bands:

"codexQuota.thresholds": {
  "redBelowPercent": 5,
  "amberBelowPercent": 50
}

Changes apply immediately, with no reload.

VS Code only allows extensions two status bar background colors at all (statusBarItem.errorBackground and statusBarItem.warningBackground); every other background id is silently dropped by the extension host, so a green background is not possible. The healthy state is therefore signaled with green text (#2EA043, chosen to stay readable on both dark and light themes).

The red and amber tints are translucent theme colors. If you prefer solid fills, override them:

"workbench.colorCustomizations": {
  "statusBarItem.errorBackground": "#8B2323",
  "statusBarItem.warningBackground": "#9A6700"
}

High-contrast themes deliberately get no background fill. When data is unavailable the colors are cleared.

Requirements

  • VS Code 1.74+
  • The official Codex CLI, installed and on VS Code's PATH (or set codexQuota.codexPath), logged in (codex login). When the setting is left at its default, the extension also discovers the current Codex binary bundled with the installed OpenAI ChatGPT extension, so extension updates do not leave a stale versioned path behind.

Installation

code --install-extension codex-quota-<version>.vsix

Then run Developer: Reload Window if the status bar item does not appear.

Settings

Setting Default Description
codexQuota.codexPath codex Path to the codex executable. Set this if VS Code does not inherit your shell PATH.
codexQuota.refreshIntervalSeconds 60 Refresh interval in seconds (minimum 15).
codexQuota.thresholds { "redBelowPercent": 10, "amberBelowPercent": 30 } Color-band thresholds in percent remaining: below redBelowPercent shows the red tint, below amberBelowPercent the amber tint, otherwise green text. Red is checked first; values are clamped to 0–100.
codexQuota.mcp.enabled false Lets coding agents read this quota through the MCP server. Toggle it from the link at the foot of the status bar tooltip.

Security / privacy design

This extension does:

  • start the official local Codex app-server (codex app-server) as a child process
  • request Codex rate-limit/quota metadata from it over local stdio
  • show that data in the VS Code status bar

This extension does not:

  • read Codex credential files (~/.codex/auth.json and friends)
  • read Codex session files
  • read workspace source code
  • send telemetry
  • send credentials anywhere
  • make independent HTTP/network requests
  • invoke Codex model prompts or consume quota

Because the extension launches the official Codex CLI under your own account, the Codex process itself performs whatever authenticated communication Codex requires. This extension only reads the rate-limit metadata that Codex returns and renders it locally.

Troubleshooting

  • $(warning) Codex ? means the last refresh failed; hover the item for the reason. $(key) Codex ? means Codex is not logged in.

  • Check the CLI works in a terminal:

    codex --version
    codex app-server --help
    
  • If codex is not found from within VS Code (e.g. VS Code was launched from the desktop and does not inherit your shell PATH), point codexQuota.codexPath at the absolute path of the codex executable. An explicitly configured path takes precedence over automatic discovery.

  • If you are not logged in, run codex login in a terminal; this extension never performs authentication.

  • The Codex Quota output channel (View → Output) contains sanitized status lines (fixed failure reason codes, no response data).

Privacy and workspace trust

This extension is disabled in untrusted and virtual workspaces. Set codexQuota.codexPath in User settings; project settings cannot choose an executable. The CLI runs with your local account permissions. No telemetry is sent by this extension. Review provider-specific credential handling above. Never include keys, tokens or account responses in bug reports.

Licence

Copyright © 2026 Richard Beech / 1larity. User-owned code, documentation and assets are licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0). Credit the author and source, link the licence, indicate changes, use non-commercially and share adaptations under the same licence. Third-party material retains its own terms; previous licence grants are not revoked. See LICENSE for the legal text.

JSON command line for coding agents

codex-quota prints the quota shown in the status bar as one JSON document, so an agent can check its own limits before starting long work.

node cli.js --pretty        # from the extension folder
npx . --pretty              # or install the codex-quota command: npm link

Fields: ok, provider, plan, band (green, amber or red, from the most constrained window), status (the status bar text) and windows[] with kind, label, usedPercent, remainingPercent, resetAt (ISO 8601) and resetsInSeconds. resetCreditsAvailable is the number of banked rate-limit resets. When the quota cannot be read, ok is false, error.reason and error.message say why, and the exit code is 1. CODEX_BIN selects the Codex executable (default codex).

All installed quota extensions in one document

codex-quota --all collates the quota of every installed Claude, Codex and GLM quota extension into one JSON document: providers holds each extension's own document keyed by claude, codex or glm, and summary gives the worst band and the tightest window across them. Extensions that are not installed are left out, and a provider that fails shows ok: false without affecting the others. The exit code is 0 when at least one provider answered.

Each extension records the location of its cli.js in ~/.config/quota-monitor/ ($XDG_CONFIG_HOME, $QUOTA_MONITOR_DIR or %APPDATA% where set) when it activates or its CLI runs. Any one installed extension can therefore produce the combined view.

MCP server for coding agents

mcp.js is a Model Context Protocol server (stdio) with two read-only tools:

  • get_quota returns one provider's document, the same one the command line prints. provider picks claude, codex or glm and defaults to codex.
  • get_all_quotas returns the combined document of --all.

The server is off by default. Turn it on with the link at the foot of the status bar tooltip, the Codex Quota: Toggle MCP Server command, or the codexQuota.mcp.enabled setting. Each provider answers only while its own extension's toggle is on; otherwise its document has ok: false and error.reason mcp-disabled. A change applies from the next tool call, with no agent restart.

While it is on, VS Code 1.101 and later list the server under their MCP servers, running with this extension's own settings and credentials. Other agents start it with node <folder>/mcp.js, where <folder> is this extension's folder or a source checkout. The installed folder name includes the version, so a source checkout gives a path that survives updates. Outside VS Code the server runs codex from PATH; set CODEX_BIN in the agent config to use another executable.

# Claude Code
claude mcp add -s user quota -- node <folder>/mcp.js
# Codex: ~/.codex/config.toml
[mcp_servers.quota]
command = "node"
args = ["<folder>/mcp.js"]
// Kilo: ~/.config/kilo/kilo.jsonc
"mcp": { "quota": { "type": "local", "command": ["node", "<folder>/mcp.js"], "enabled": true } }

Any one server reports all installed providers, so one entry per agent is enough. Give that entry ZAI_API_KEY_COMMAND (see the GLM Quota README) so GLM can answer through it too.

Developer guide

The extension is plain CommonJS JavaScript with no runtime npm dependencies and no compilation step. Use Node.js 22+ for development.

npm test
node --check extension.js
npx --yes @vscode/vsce@4.1.1 package --no-dependencies --githubBranch public

Open the checkout in VS Code and press F5 to launch an Extension Development Host. Run npm test for the offline test suite.

  • extension.js: VS Code integration.
  • lib/: provider clients, parsers and monitor lifecycle.
  • test/: offline regression coverage.
  • .vscodeignore: files included in the extension package.

See SECURITY.md for sensitive reporting guidance.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft