Metadata-Version: 2.4
Name: quse
Version: 0.0.4
Summary: Quota and usage checks for coding-agent CLIs.
Project-URL: Homepage, https://github.com/alexeygrigorev/quse
Project-URL: Repository, https://github.com/alexeygrigorev/quse
Project-URL: Issues, https://github.com/alexeygrigorev/quse/issues
Author: Alexey Grigorev
License: MIT
Keywords: claude,codex,copilot,quota,usage
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.11
Requires-Dist: click>=8.2.0
Description-Content-Type: text/markdown

# 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.

```bash
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:

```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` is hardcoded to `100%` remaining, `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.

## Release

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

```bash
git tag v0.0.4
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`.
