gemini-cli-usage 0.1.9__tar.gz → 0.4.0__tar.gz

gemini_cli_usage-0.4.0/.gitignore

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

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

gemini_cli_usage-0.4.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.5
+Name: gemini-cli-usage
+Version: 0.4.0
+Summary: Gemini CLI model quota 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: cli,gemini,gemini-cli,google,quota,statusline,usage
+Requires-Python: >=3.12
+Requires-Dist: clanker-usage==0.4.0
+Description-Content-Type: text/markdown
+
+# gemini-cli-usage
+
+Monitor your Gemini CLI quota from the terminal: current usage, a one-line statusline, and a daemon that keeps a cache fresh.
+
+```sh
+uv tool install gemini-cli-usage
+gemini-cli-usage              # current quotas
+gemini-cli-usage statusline   # one line, from a cache less than five minutes old
+gemini-cli-usage json         # the usage-v1 document
+```
+
+`gemini-cli-usage` is the Gemini CLI command of [clanker-usage](https://github.com/wakamex/clanker-usage), so it installs clanker-usage at the same version. The documentation lives there.

gemini_cli_usage-0.4.0/README.md

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

gemini_cli_usage-0.4.0/gemini_cli_usage/__init__.py

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

gemini_cli_usage-0.4.0/gemini_cli_usage/__main__.py

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

gemini_cli_usage-0.4.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["hatchling==1.32.4"]
+build-backend = "hatchling.build"
+
+[project]
+name = "gemini-cli-usage"
+version = "0.4.0"
+description = "Gemini CLI model quota monitor"
+readme = "README.md"
+keywords = ["gemini", "gemini-cli", "google", "usage", "quota", "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]
+gemini-cli-usage = "gemini_cli_usage:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["gemini_cli_usage"]

gemini_cli_usage-0.1.9/.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

gemini_cli_usage-0.1.9/.gitignore

@@ -1,2 +0,0 @@
-__pycache__/
-*.py[cod]

gemini_cli_usage-0.1.9/PKG-INFO

@@ -1,120 +0,0 @@
-Metadata-Version: 2.5
-Name: gemini-cli-usage
-Version: 0.1.9
-Summary: Gemini CLI quota monitor — fetches Code Assist quota data from Google's backend
-Project-URL: Homepage, https://github.com/wakamex/gemini-cli-usage
-Project-URL: Source, https://github.com/wakamex/gemini-cli-usage
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-
-# gemini-cli-usage
-
-Gemini CLI quota monitor. Fetches live Code Assist quota data from Google's
-backend when Gemini is using Google login.
-
-## Example output
-
-`gemini-cli-usage` command:
-
-```text
-Project: gemini-cli-usage
-Auth: Google login
-  gemini-2.5-pro        3.5% used  resets 19h38m
-  gemini-2.5-flash-lite 0.07% used  resets 19h37m
-```
-
-`gemini-cli-usage statusline` command:
-
-```text
-q:3.5% reset:19h38m
-```
-
-## Install
-
-```bash
-uv tool install gemini-cli-usage
-```
-
-For local development from a checkout:
-
-```bash
-uv tool install .
-```
-
-Then run:
-
-```bash
-# Check usage once
-gemini-cli-usage
-
-# Raw JSON
-gemini-cli-usage json
-
-# Compact shell/statusline output
-gemini-cli-usage statusline
-
-# Force a fresh cache rebuild and print full status
-gemini-cli-usage refresh
-
-# Keep ~/.gemini/usage-limits.json fresh
-gemini-cli-usage daemon
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `gemini-cli-usage` | Show current usage (colored terminal output) |
-| `gemini-cli-usage status` | Same as above |
-| `gemini-cli-usage json` | Print raw JSON |
-| `gemini-cli-usage daemon [-i SECS]` | Run in foreground, refresh every 5 min |
-| `gemini-cli-usage statusline` | Compact statusline (reads cache, refreshes if stale) |
-| `gemini-cli-usage refresh` | Force a fresh fetch, rewrite cache, and print status |
-| `gemini-cli-usage install` | Print setup instructions |
-
-## Data source
-
-### `account_quota`
-
-When Gemini CLI is configured for Google login (`oauth-personal`), it calls
-Google's internal Code Assist API:
-
-- `loadCodeAssist`
-- `retrieveUserQuota`
-
-This tool mirrors that flow using the OAuth credentials in
-`~/.gemini/oauth_creds.json`. When `GEMINI_CLI_HOME` is set, it follows Gemini
-CLI and uses `$GEMINI_CLI_HOME/.gemini` instead.
-
-## Notes
-
-- Quota fetches are best-effort. If auth is not Google login, or quota lookup
-  fails, the tool reports the auth state plus the quota error.
-- If the Google OAuth access token expires, the tool reuses Gemini CLI's
-  installed OAuth client metadata when available. If Gemini is installed in a
-  nonstandard location, set `GEMINI_OAUTH_CLIENT_ID` and
-  `GEMINI_OAUTH_CLIENT_SECRET`, or rerun `gemini` and retry.
-- `status` and `json` always build fresh data.
-- `statusline` reads the cache by default; use `--refresh` or `--max-age 0` to
-  force a live refresh.
-- `refresh` is a convenience command that rebuilds the cache and prints the full
-  status output.
-- Absolute quota counts are only shown when Google's response includes both
-  `remainingAmount` and a usable fraction. Otherwise the tool reports `% used`
-  plus reset time.
-- Auth detection follows Gemini CLI precedence: environment variables first,
-  then workspace `.gemini/settings.json`, then the global settings file under
-  the effective Gemini CLI home.
-
-## Options
-
-```text
-usage: gemini-cli-usage [-h] [--root ROOT] [--interval INTERVAL]
-                        [--max-age MAX_AGE] [--refresh]
-                        {status,json,daemon,statusline,refresh,install}
-```
-
-- `--root ROOT`: inspect a different project root instead of the current
-  directory
-- `--max-age MAX_AGE`: cache TTL for `statusline`
-- `--refresh`: ignore the cache and rebuild fresh data where applicable

gemini_cli_usage-0.1.9/README.md

@@ -1,111 +0,0 @@
-# gemini-cli-usage
-
-Gemini CLI quota monitor. Fetches live Code Assist quota data from Google's
-backend when Gemini is using Google login.
-
-## Example output
-
-`gemini-cli-usage` command:
-
-```text
-Project: gemini-cli-usage
-Auth: Google login
-  gemini-2.5-pro        3.5% used  resets 19h38m
-  gemini-2.5-flash-lite 0.07% used  resets 19h37m
-```
-
-`gemini-cli-usage statusline` command:
-
-```text
-q:3.5% reset:19h38m
-```
-
-## Install
-
-```bash
-uv tool install gemini-cli-usage
-```
-
-For local development from a checkout:
-
-```bash
-uv tool install .
-```
-
-Then run:
-
-```bash
-# Check usage once
-gemini-cli-usage
-
-# Raw JSON
-gemini-cli-usage json
-
-# Compact shell/statusline output
-gemini-cli-usage statusline
-
-# Force a fresh cache rebuild and print full status
-gemini-cli-usage refresh
-
-# Keep ~/.gemini/usage-limits.json fresh
-gemini-cli-usage daemon
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `gemini-cli-usage` | Show current usage (colored terminal output) |
-| `gemini-cli-usage status` | Same as above |
-| `gemini-cli-usage json` | Print raw JSON |
-| `gemini-cli-usage daemon [-i SECS]` | Run in foreground, refresh every 5 min |
-| `gemini-cli-usage statusline` | Compact statusline (reads cache, refreshes if stale) |
-| `gemini-cli-usage refresh` | Force a fresh fetch, rewrite cache, and print status |
-| `gemini-cli-usage install` | Print setup instructions |
-
-## Data source
-
-### `account_quota`
-
-When Gemini CLI is configured for Google login (`oauth-personal`), it calls
-Google's internal Code Assist API:
-
-- `loadCodeAssist`
-- `retrieveUserQuota`
-
-This tool mirrors that flow using the OAuth credentials in
-`~/.gemini/oauth_creds.json`. When `GEMINI_CLI_HOME` is set, it follows Gemini
-CLI and uses `$GEMINI_CLI_HOME/.gemini` instead.
-
-## Notes
-
-- Quota fetches are best-effort. If auth is not Google login, or quota lookup
-  fails, the tool reports the auth state plus the quota error.
-- If the Google OAuth access token expires, the tool reuses Gemini CLI's
-  installed OAuth client metadata when available. If Gemini is installed in a
-  nonstandard location, set `GEMINI_OAUTH_CLIENT_ID` and
-  `GEMINI_OAUTH_CLIENT_SECRET`, or rerun `gemini` and retry.
-- `status` and `json` always build fresh data.
-- `statusline` reads the cache by default; use `--refresh` or `--max-age 0` to
-  force a live refresh.
-- `refresh` is a convenience command that rebuilds the cache and prints the full
-  status output.
-- Absolute quota counts are only shown when Google's response includes both
-  `remainingAmount` and a usable fraction. Otherwise the tool reports `% used`
-  plus reset time.
-- Auth detection follows Gemini CLI precedence: environment variables first,
-  then workspace `.gemini/settings.json`, then the global settings file under
-  the effective Gemini CLI home.
-
-## Options
-
-```text
-usage: gemini-cli-usage [-h] [--root ROOT] [--interval INTERVAL]
-                        [--max-age MAX_AGE] [--refresh]
-                        {status,json,daemon,statusline,refresh,install}
-```
-
-- `--root ROOT`: inspect a different project root instead of the current
-  directory
-- `--max-age MAX_AGE`: cache TTL for `statusline`
-- `--refresh`: ignore the cache and rebuild fresh data where applicable

gemini_cli_usage-0.1.9/pyproject.toml

@@ -1,24 +0,0 @@
-[project]
-name = "gemini-cli-usage"
-version = "0.1.9"
-description = "Gemini CLI quota monitor — fetches Code Assist quota data from Google's backend"
-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/gemini_cli_usage"]
-
-[project.urls]
-Homepage = "https://github.com/wakamex/gemini-cli-usage"
-Source = "https://github.com/wakamex/gemini-cli-usage"
-
-[project.scripts]
-gemini-cli-usage = "gemini_cli_usage:main"