codex-cli-usage 0.1.10__tar.gz → 0.4.0__tar.gz

codex_cli_usage-0.4.0/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+.venv/
+dist/
+dist-wrappers/

codex_cli_usage-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mihai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codex_cli_usage-0.4.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.5
+Name: codex-cli-usage
+Version: 0.4.0
+Summary: Codex rate limit monitor
+Project-URL: Homepage, https://github.com/wakamex/clanker-usage
+Project-URL: Source, https://github.com/wakamex/clanker-usage
+License-Expression: MIT
+License-File: LICENSE
+Keywords: chatgpt,cli,codex,openai,rate-limits,statusline,usage
+Requires-Python: >=3.12
+Requires-Dist: clanker-usage==0.4.0
+Description-Content-Type: text/markdown
+
+# codex-cli-usage
+
+Monitor your Codex quota from the terminal: current usage, a one-line statusline, and a daemon that keeps a cache fresh.
+
+```sh
+uv tool install codex-cli-usage
+codex-cli-usage              # current quotas
+codex-cli-usage statusline   # one line, from a cache less than five minutes old
+codex-cli-usage json         # the usage-v1 document
+```
+
+`codex-cli-usage` is the Codex command of [clanker-usage](https://github.com/wakamex/clanker-usage), so it installs clanker-usage at the same version. The documentation lives there.

codex_cli_usage-0.4.0/README.md

@@ -0,0 +1,12 @@
+# codex-cli-usage
+
+Monitor your Codex quota from the terminal: current usage, a one-line statusline, and a daemon that keeps a cache fresh.
+
+```sh
+uv tool install codex-cli-usage
+codex-cli-usage              # current quotas
+codex-cli-usage statusline   # one line, from a cache less than five minutes old
+codex-cli-usage json         # the usage-v1 document
+```
+
+`codex-cli-usage` is the Codex command of [clanker-usage](https://github.com/wakamex/clanker-usage), so it installs clanker-usage at the same version. The documentation lives there.

codex_cli_usage-0.4.0/codex_cli_usage/__init__.py

@@ -0,0 +1,7 @@
+"""codex-cli-usage: the Codex command of clanker-usage."""
+
+from clanker_usage import run
+
+
+def main():
+    return run("codex")

codex_cli_usage-0.4.0/codex_cli_usage/__main__.py

@@ -0,0 +1,3 @@
+from . import main
+
+raise SystemExit(main())

codex_cli_usage-0.4.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["hatchling==1.32.4"]
+build-backend = "hatchling.build"
+
+[project]
+name = "codex-cli-usage"
+version = "0.4.0"
+description = "Codex rate limit monitor"
+readme = "README.md"
+keywords = ["codex", "openai", "chatgpt", "usage", "rate-limits", "statusline", "cli"]
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+dependencies = ["clanker-usage==0.4.0"]
+
+[project.urls]
+Homepage = "https://github.com/wakamex/clanker-usage"
+Source = "https://github.com/wakamex/clanker-usage"
+
+[project.scripts]
+codex-cli-usage = "codex_cli_usage:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["codex_cli_usage"]

codex_cli_usage-0.1.10/.github/workflows/publish.yml

@@ -1,29 +0,0 @@
-name: Publish to PyPI
-
-on:
-  push:
-    tags:
-      - "v*"
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    environment: pypi
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v7.0.1
-      - name: Install uv
-        uses: astral-sh/setup-uv@v9.0.0
-        with:
-          enable-cache: false
-      - name: Verify version tag
-        run: test "$GITHUB_REF_NAME" = "v$(uv --no-config version --short)"
-      - name: Test
-        run: uv --no-config run --locked python -m unittest discover -s tests
-      - name: Build
-        run: uv --no-config build --no-sources
-      - name: Publish
-        run: uv publish --trusted-publishing always

codex_cli_usage-0.1.10/.gitignore

@@ -1,2 +0,0 @@
-__pycache__/
-*.pyc

codex_cli_usage-0.1.10/PKG-INFO

@@ -1,116 +0,0 @@
-Metadata-Version: 2.5
-Name: codex-cli-usage
-Version: 0.1.10
-Summary: Codex CLI usage monitor — fetches rate limits through the Codex app-server
-Project-URL: Homepage, https://github.com/wakamex/codex-cli-usage
-Project-URL: Source, https://github.com/wakamex/codex-cli-usage
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-
-# codex-cli-usage
-
-Codex CLI usage monitor. Fetches your rate limit data through Codex and displays it in the terminal.
-
-## Example output
-
-`codex-cli-usage` command:
-
-```
-Plan: plus
-  Weekly               39%  resets 143h26m
-```
-
-Codex statusline (self-caching — refreshes from API when stale, no daemon needed):
-
-```
-weekly:39% plus reset:143h26m
-```
-
-## Install
-
-```bash
-uv tool install codex-cli-usage
-```
-
-Then run:
-
-```bash
-# Check usage once
-codex-cli-usage
-
-# Run the daemon (keeps usage-limits.json updated)
-codex-cli-usage daemon
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `codex-cli-usage` | Show current usage (colored terminal output) |
-| `codex-cli-usage json` | Print raw JSON |
-| `codex-cli-usage daemon [-i SECS]` | Run in foreground, refresh every 5 min (customizable) |
-| `codex-cli-usage statusline` | Compact statusline (self-caching, no daemon needed) |
-| `codex-cli-usage install` | Print setup instructions |
-
-## How Codex CLI rate limiting works
-
-Discovered by inspecting the Codex CLI and its authentication flow.
-
-### Data sources
-
-codex-cli-usage gets rate limit data from:
-
-1. **`codex app-server --stdio`** — Preferred. Codex owns authentication and returns rate limits through `account/rateLimits/read`.
-2. **`/backend-api/codex/usage` endpoint** — Compatibility fallback when Codex is missing or its app-server does not support the rate-limit method.
-
-### Rate limit types
-
-| Type | Description |
-|------|-------------|
-| `primary_window` | Primary window; duration comes from `limit_window_seconds` |
-| `secondary_window` | Secondary window; duration comes from `limit_window_seconds` |
-| `additional_rate_limits` | Per-model limits (e.g. specific model caps) |
-| `code_review_rate_limit` | Code review usage limit |
-
-Window names are derived from `limit_window_seconds`, not from whether the
-backend calls a window primary or secondary. Approximately 5-hour, daily,
-weekly, monthly, and annual windows receive duration labels. Other or missing
-durations are shown as `Primary` or `Secondary`. Additional per-model limits
-remain available in JSON for compatibility but are not shown in normal output.
-
-### Cache format
-
-Schema version 2 stores aggregate windows by their backend role while retaining
-their actual duration:
-
-```json
-{
-  "schema_version": 2,
-  "primary": {
-    "pct": 39,
-    "resets_at": "2026-07-18T20:00:00+00:00",
-    "window_secs": 604800
-  }
-}
-```
-
-Legacy `5h` and `7d` aliases are written only when the corresponding aggregate
-window actually classifies as 5-hour or weekly. Readers should prefer
-`primary` and `secondary`.
-
-### Authentication
-
-The OAuth tokens live at `~/.codex/auth.json` by default and are written by the
-Codex CLI on login. When `CODEX_HOME` is set, the direct compatibility fallback
-reads `$CODEX_HOME/auth.json`. The preferred app-server path leaves credential
-resolution to Codex.
-
-Codex owns automatic token refresh and credential persistence. The compatibility
-fallback reads `auth.json` but never modifies credentials.
-
-### Local files
-
-| File | Written by | Contains |
-|------|-----------|----------|
-| `~/.codex/auth.json` | Codex CLI | OAuth tokens (access, refresh, id_token) |
-| `~/.codex/usage-limits.json` | codex-cli-usage daemon | Cached API usage data (this tool) |

codex_cli_usage-0.1.10/README.md

@@ -1,107 +0,0 @@
-# codex-cli-usage
-
-Codex CLI usage monitor. Fetches your rate limit data through Codex and displays it in the terminal.
-
-## Example output
-
-`codex-cli-usage` command:
-
-```
-Plan: plus
-  Weekly               39%  resets 143h26m
-```
-
-Codex statusline (self-caching — refreshes from API when stale, no daemon needed):
-
-```
-weekly:39% plus reset:143h26m
-```
-
-## Install
-
-```bash
-uv tool install codex-cli-usage
-```
-
-Then run:
-
-```bash
-# Check usage once
-codex-cli-usage
-
-# Run the daemon (keeps usage-limits.json updated)
-codex-cli-usage daemon
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `codex-cli-usage` | Show current usage (colored terminal output) |
-| `codex-cli-usage json` | Print raw JSON |
-| `codex-cli-usage daemon [-i SECS]` | Run in foreground, refresh every 5 min (customizable) |
-| `codex-cli-usage statusline` | Compact statusline (self-caching, no daemon needed) |
-| `codex-cli-usage install` | Print setup instructions |
-
-## How Codex CLI rate limiting works
-
-Discovered by inspecting the Codex CLI and its authentication flow.
-
-### Data sources
-
-codex-cli-usage gets rate limit data from:
-
-1. **`codex app-server --stdio`** — Preferred. Codex owns authentication and returns rate limits through `account/rateLimits/read`.
-2. **`/backend-api/codex/usage` endpoint** — Compatibility fallback when Codex is missing or its app-server does not support the rate-limit method.
-
-### Rate limit types
-
-| Type | Description |
-|------|-------------|
-| `primary_window` | Primary window; duration comes from `limit_window_seconds` |
-| `secondary_window` | Secondary window; duration comes from `limit_window_seconds` |
-| `additional_rate_limits` | Per-model limits (e.g. specific model caps) |
-| `code_review_rate_limit` | Code review usage limit |
-
-Window names are derived from `limit_window_seconds`, not from whether the
-backend calls a window primary or secondary. Approximately 5-hour, daily,
-weekly, monthly, and annual windows receive duration labels. Other or missing
-durations are shown as `Primary` or `Secondary`. Additional per-model limits
-remain available in JSON for compatibility but are not shown in normal output.
-
-### Cache format
-
-Schema version 2 stores aggregate windows by their backend role while retaining
-their actual duration:
-
-```json
-{
-  "schema_version": 2,
-  "primary": {
-    "pct": 39,
-    "resets_at": "2026-07-18T20:00:00+00:00",
-    "window_secs": 604800
-  }
-}
-```
-
-Legacy `5h` and `7d` aliases are written only when the corresponding aggregate
-window actually classifies as 5-hour or weekly. Readers should prefer
-`primary` and `secondary`.
-
-### Authentication
-
-The OAuth tokens live at `~/.codex/auth.json` by default and are written by the
-Codex CLI on login. When `CODEX_HOME` is set, the direct compatibility fallback
-reads `$CODEX_HOME/auth.json`. The preferred app-server path leaves credential
-resolution to Codex.
-
-Codex owns automatic token refresh and credential persistence. The compatibility
-fallback reads `auth.json` but never modifies credentials.
-
-### Local files
-
-| File | Written by | Contains |
-|------|-----------|----------|
-| `~/.codex/auth.json` | Codex CLI | OAuth tokens (access, refresh, id_token) |
-| `~/.codex/usage-limits.json` | codex-cli-usage daemon | Cached API usage data (this tool) |

codex_cli_usage-0.1.10/pyproject.toml

@@ -1,24 +0,0 @@
-[project]
-name = "codex-cli-usage"
-version = "0.1.10"
-description = "Codex CLI usage monitor — fetches rate limits through the Codex app-server"
-readme = "README.md"
-requires-python = ">=3.12"
-dependencies = []
-
-[tool.uv]
-package = true
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/codex_cli_usage"]
-
-[project.urls]
-Homepage = "https://github.com/wakamex/codex-cli-usage"
-Source = "https://github.com/wakamex/codex-cli-usage"
-
-[project.scripts]
-codex-cli-usage = "codex_cli_usage:main"