quse 0.0.5

Quota and usage checks for coding-agent CLIs.

quse

Quota and usage checks for coding-agent CLIs.

quse reports normalized usage for providers used by tools such as Codex, Claude Code, GitHub Copilot, and Z.AI/goz.

quse
quse codex
quse copilot --json

The CLI prints one normalized line per provider by default. --json emits the same normalized record shape as JSON:

{"provider":"claude","status":"ok","short_term":{"percent_remaining":55.0,"reset_at":"2026-05-24T14:30:00Z"},"long_term":{"percent_remaining":87.0,"reset_at":"2026-05-28T14:59:59Z"}}

Supported providers:

• codex
• claude
• copilot
• zai

gemini is accepted and reports unsupported because it does not currently expose a usage endpoint.

Provider mapping:

• codex: short_term maps to the primary window, long_term maps to the weekly API window.
• claude: short_term maps to the 5-hour signal, long_term maps to the 7-day signal.
• copilot: short_term is hardcoded to 100% remaining, long_term maps to the monthly premium-interactions signal.
• zai: short_term maps to the tokens signal, long_term is hardcoded to 100% remaining.

Install

For a local checkout, install the project environment and add its .venv/bin to your shell PATH:

uv sync --dev
./install.sh

Open a new shell after running ./install.sh, then verify:

quse --help

This is the same local-checkout style used by tmuxctl: the script appends the checkout's .venv/bin directory to ~/.bashrc.

For one-off use from a checkout without changing PATH:

uv run quse
uv run quse codex --json

For the latest released package from PyPI:

uvx quse
uv tool install quse
# or
pipx install quse

Use uvx quse for a one-off run without installing a persistent tool.

Release

Releases are published by GitHub Actions when a tag starting with v is pushed:

git tag v0.0.5
git push origin main --tags

The workflow verifies that the tag version matches pyproject.toml, runs the tests, builds the wheel and sdist, then publishes to PyPI with the repository secret PYPI_API_TOKEN.