quotagauge
Capture ·
Install ·
CLI reference ·
Bounds ·
Troubleshooting
Claude Code and Codex enforce rolling usage limits but show the numbers only to a human, so the model never sees them and can keep working right up to the wall. quotagauge captures those readings and warns the model when it should conserve usage.
Install and first run
The shortest path:
uv tool install quotagauge
quotagauge init --all
quotagauge status
To work from a clone instead, run one of these:
uv tool install .
pip install -e .
Then run quotagauge init --all and quotagauge status. Plain quotagauge init configures Claude Code only, while --codex configures Codex only. See the installation guide for safe previews and the plain-clone fallback.
Example output
quotagauge status reports every source and window:
Claude
5h: 12% used [ok], resets in 1h 59m
7d: unavailable
Codex
5h: unavailable
7d: >=94% used [critical], resets in 1h 59m
Near a limit, the prompt hook gives the model a short action:
Usage headroom: Codex weekly >=94% used (reading 1h 0m old), resets in 1h 59m.
Stop parallel subagent fan-out, use cheaper models, and checkpoint work now.
Documentation
| Document | What it covers |
|---|---|
| CLI reference | Every command, flag, environment variable, state file, exit code, and the opt-in update check. |
| Why the bounds are sound | Fresh, stale, and post-reset readings, reset validation, and severity. |
| How capture works | Claude statusline input, Codex app-server RPC, and rollout fallback. |
| Installation guide | Claude Code settings, the CODEX_HOME/hooks.json path, safe init previews, backups, and clone installs. |
| Troubleshooting | Unavailable or stale readings, unknown resets, doctor output, and state reset. |
1 maintainer
Metadata
1 maintainer
Release files for quotagauge 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| quotagauge-0.2.0.tar.gz | 798.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| quotagauge-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 894.7 kB
Release files / quotagauge-0.2.0.tar.gz
| Download URL | quotagauge-0.2.0.tar.gz |
|---|---|
| Size | 798.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a8460aa77b9428f228daac1cc49401242982b47e939b63082a2c586c0b4afad4
|
|
BLAKE2b-256 checksum How to use checksums |
81b789c05b4e07ef3f06b40ada1612937c07ea4d9b4f989cf23e016a8e48465f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / quotagauge-0.2.0-py3-none-any.whl
| Download URL | quotagauge-0.2.0-py3-none-any.whl |
|---|---|
| Size | 96.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6819dc52d1575ac2169023925c6ec549be8cf47724195bc9887c605bd86905fc
|
|
BLAKE2b-256 checksum How to use checksums |
ae9445ad7ed5278490a62e09fee33543d2d1536d3667c5067cfe14df2d73778d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
