Codex Quota Guard MCP v0.6.0
Highlights
- Uses only the current Codex ChatGPT session through the official
codex app-server; API-key, Bedrock, signed-out, and unstable identities fail safe withCHATGPT_LOGIN_REQUIREDand expose no quota percentages. - Replaces persistent Windows supervision with one authenticated on-demand loopback core and lightweight per-task connectors.
- Connector leases renew every 20 seconds, expire after 60 seconds after a crash, and allow the core to stop about five seconds after the final clean disconnect.
- Five-minute early-recovery polling runs only while a connector, active defer, and scheduler capability are all present.
- Removes Scheduled Task, service/daemon,
wscript, Codex PID scanning, login flows, OAuth fallback, and direct auth-file access. - Adds one installer for Windows, WSL-hosted Windows usage, Linux, and macOS while preserving unrelated Codex configuration.
- Keeps all eight MCP tools. The metadata now tells Codex to check near long work segments rather than before every command or small read.
Compatibility and verification
CI passed the full check, disposable installer fixture, six-concurrent-connector singleton acceptance, and package dry run on Node.js 22 and 24 across:
- Windows x64 and Windows ARM64
- Ubuntu x64 and Ubuntu ARM64
- macOS Intel and Apple Silicon
Windows running in a VM is treated as ordinary Windows; there is no hypervisor-specific code path.
Install
This package remains private and is installed from the GitHub checkout:
npm ci
npm run check
node scripts/install.mjs
Restart or reconnect Codex after installation. See the README for Windows/WSL state-sharing and uninstall instructions.