CLIProxyAPI · Codex OAuth Pool · 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, 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.

Agent consumable

Exposes /api/recommendations, /api/diagnostics, /api/alerts, and Prometheus /metrics.

Self-hosted by default

Runs as a Python app, Nix flake package/app, or NixOS service module. The default bind stays on 127.0.0.1.

Quick start

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

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

Documentation

Quick Start Nix and Python run commands Agent Discovery When an agent should choose this project Benchmark Fast, baseline, Team, and Plus calibration Agent Deploy Prompt template for coding agents NixOS Module Declarative service options