CLIProxyAPI · Codex OAuth Pool · PyPI · Docker · NixOS

Quota-first dashboard for Codex OAuth pools.

A self-hosted monitor for operators running multiple Codex auth files behind CLIProxyAPI. Track 5h and weekly pool capacity, CPA usage, reset windows, account health, Stats time-series curves, and machine-readable agent recommendations.

View on GitHub Run it locally

Built for pool operations

Codex and CPA aware

Combines CPA management state, CPA usage statistics, optional direct Codex quota windows, and optional SQLite history for Trends, Audit, and Stats curves.

Agent consumable

Exposes /api/v1/recommendations, /api/v1/diagnostics, /api/v1/alerts, /api/v1/stats/series, OpenAPI, and Prometheus /metrics.

Self-hosted by default

Runs from PyPI, Docker/GHCR, Nix flake package/app, or NixOS service module. Host exposure stays loopback-first, with init, doctor, and a public security self-audit for sensitive CPA state.

Quick start

Run against a local CLIProxyAPI management gateway, management key, and optional auth-file directory.

nix run github:xsyxnx/codex-quota-monitor/v0.2.0#codex-quota-monitor -- \
  --management-base-url http://127.0.0.1:8317 \
  --management-key-file /path/to/management-key \
  --gateway-health-url http://127.0.0.1:8317/healthz \
  --auth-dir /path/to/auth-files

codex-quota-monitor init --mode user
codex-quota-monitor doctor

Documentation

Quick Start Nix, PyPI, and Docker run commands Install Debian, Ubuntu, Docker Desktop, and Windows notes Agent Discovery When an agent should choose this project Use Cases User workflows, coverage matrix, and non-goals Runtime Language Why the service stays Python for now Benchmark Fast, baseline, Team, and Plus calibration API Versioned endpoint contracts, OpenAPI, metrics, and redacted examples Limitations Product scope, data accuracy, deployment, and security limits Security Self-Audit Data flow, secret handling, and local checks Agent Deploy Prompt template for coding agents NixOS Module Declarative service options Troubleshooting Health, diagnostics, alerts, and safe support data Upgrade Compatibility, backup, upgrade, and rollback checks Release Checklist Preflight, tag gating, and post-publish checks v0.2.0 Forum Post Copyable launch announcement for first users