Codex Quota Monitor
Codex Quota Monitor shows your local Codex quota in the VS Code status bar:
- 5-hour window
- weekly window
- reset time and source details on hover
- click the status bar item to refresh realtime quota
- manual refresh command
By default, automatic refreshes read lightweight local Codex quota events. Clicking the status bar item starts a temporary local Codex app-server, reads realtime quota, then stops that process. The extension falls back to local Codex session logs and the local ~/.codex/logs_2.sqlite log database. It does not read auth.json, API keys, or token files.
Requirements
- Codex must have produced at least one response that contains a
codex.rate_limits event.
sqlite3 is only needed for the fallback database reader. It must be available on your PATH, or configured with codexMonitor.sqliteCommand.- Realtime quota uses the Codex executable and the local app-server protocol. Configure
codexMonitor.codexCommand if auto-detection cannot find Codex.
Commands
Codex Quota Monitor: RefreshCodex Quota Monitor: Open Settings
Settings
codexMonitor.codexHome: Codex home directory. Defaults to ~/.codex.codexMonitor.databasePath: explicit path to logs_2.sqlite.codexMonitor.sqliteCommand: sqlite3 executable. Defaults to sqlite3.codexMonitor.codexCommand: Codex executable for realtime quota reads.codexMonitor.realtimeFetchEnabled: enable realtime quota reads. Defaults to true.codexMonitor.realtimeFetchMode: onClick, always, or off. Defaults to onClick.codexMonitor.realtimeFetchTimeoutSeconds: realtime request timeout. Defaults to 20.codexMonitor.refreshIntervalSeconds: refresh interval. Defaults to 60.codexMonitor.displayMode: remaining or used. Defaults to remaining.
Package
npm run package
This creates a .vsix file that can be installed locally or uploaded to the VS Code Marketplace.
Publish
The package is prepared with:
- author:
Tricker
- publisher:
tricker
Before publishing, make sure your Marketplace publisher ID is tricker, or change the publisher field in package.json to your actual publisher ID.
vsce login tricker
npm run publish
Privacy
The extension does not read token files. Realtime quota is requested through the local Codex executable and app-server protocol; fallback reads local quota metadata from Codex session logs and the local log database.
