show-usage
/show-usage
Pokazuje zużycie limitów i kwot w subskrypcjach AI do kodowania, np. Claude, Codex i Gemini, z procentem i czasem resetu.
- Autor
- ratacat ↗
- Repozytorium
- ratacats-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 22.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 3
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 22.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: usage.py
Co robi i kiedy
Pokazuje zużycie limitów i kwot w subskrypcjach AI do kodowania, np. Claude, Codex i Gemini, z procentem i czasem resetu.
Oryginalny opis (EN)
Show rate-limit and quota usage across the user's AI coding subscriptions (Claude, Codex, Gemini, Kimi, MiniMax, Z.ai, Qwen, Grok) with per-window percent used and time to reset. Use when the user asks about usage, quotas, rate limits, or when subscriptions reset.
Jak działa
- Tools
- First run
- Every run
- JSON
- Changing usage.py
Podgląd SKILL.md
---
name: show-usage
description: "Show rate-limit and quota usage across the user's AI coding subscriptions (Claude, Codex, Gemini, Kimi, MiniMax, Z.ai, Qwen, Grok) with per-window percent used and time to reset. Use when the user asks about usage, quotas, rate limits, or when subscriptions reset."
metadata:
category: tools
blurb: "Reads live quota windows across AI coding subscriptions and prints percent used and time to reset in a minimal fixed format."
keywords:
- usage
- quota
- rate-limit
- subscriptions
- claude
- codex
- kimi
- minimax
- zai
- qwen
---
# Show Usage
`usage.py` in this skill folder reads every subscription and prints the report. Print its output as is.
## Tools
`usage.py` calls these tools. Install any that are missing:
| Tool | Install | Reads |
| --- | --- | --- |
| `ait` | `cargo install aitracker --locked` (needs Rust) | Codex, once per `~/.codex*` folder that has an `auth.json` |
| `aiquokka` | `go install github.com/McKean/aiquokka@latest` (needs Go; binary at `~/go/bin/aiquokka`) | Kimi (`KIMI_API_KEY`) |
| `qwencloud` | `npm install -g @qwencloud/qwencloud-cli` | Qwen free tier (needs `qwencloud login` once) |
| `omp` | never install; used only if already on PATH | Z.ai, Grok |
`usage.py` reads the rest itself: Claude from each `~/.claude*` folder that has a `.credentials.json`, Gemini from each VibeProxy login `~/.cli-proxy-api/antigravity-*.json`, and MiniMax with `MINIMAX_API_KEY`.
## First run
1. Install missing tools.
2. Run `python3 <skill dir>/usage.py`. Its stderr names each source that failed (bad key, needs login, no plan).
3. Ask the user: any other subscriptions to include, and whether the detected set is right.
4. Record the confirmed list in `~/.config/show-usage/providers`, one per line, from `claude`, `codex`, `gemini`, `kimi`, `zai`, `minimax`, `grok`, `qwen`. `usage.py` reads only the listed providers.
## Every run
Run `python3 <skill dir>/usage.py`, print its stdout exactly, and exit. No notes, no follow-up questions.
```
Claude (cheshire)
5h 32% used 0h 8m
weekly 86% used 18h 38m
fable-weekly 10% used 18h 38m
Codex (cheshire)
7-day 4% used 6d 16h
MiniMax
general-5h 1% used 4h 38m
general-weekly 0% used 2d 23h
```
A window with no time has not started; its clock starts on first use.
## JSON
`usage.py --json` prints one usage reading per line:
```
{"usage": "codex:cheshire", "window": "7d", "used": 4.0, "resetsAt": "2026-10-29T17:12:46Z"}
```
- `usage` names the account: the provider, and the login name when the provider has several logins (`claude:cheshire`, `codex:cheshire`, `minimax`).
- `window` is the window length, with the model group after a colon when the window counts only some models (`5h`, `7d`, `7d:fable`).
- `used` is a percent. `resetsAt` is UTC, or null.
SourceWalk's account queue runs it (`usageCommand` in `~/.sourcewalk/capacity.yaml`) and matches accounts and reserves by these ids. Keep them stable.
## Changing usage.py
- A program can run it as `/usr/bin/python3` (3.9) with a short PATH, so use no newer syntax, and find tools in `~/go/bin`, `~/.cargo/bin`, and `~/.bun/bin` too.
- SourceWalk kills a run after 60 seconds. So `--json` prints each account's lines when its source is done, and each tool call stops after 45 seconds.
- Codex refresh tokens are single-use. `ait` only reads `auth.json` and never refreshes it. Never add a Codex refresh, and never share a `CODEX_HOME` folder between two tools that refresh.
- Claude Code keeps each login in `<config dir>/.credentials.json`, not the keychain. `usage.py` refreshes an expired token and writes it back to that file, so Claude Code reads the new token.
- MiniMax interval windows are fixed 5-hour blocks in UTC, and the last block of the day is 4 hours. The text label gives the real length (`general-4h`). The JSON window stays `5h`.
- Gemini needs the current Antigravity version in its User-Agent. An old version gets only the Claude and GPT group.
- Qwen prints one `free-tier` line: the highest `used_pct` of the models with status `valid`, and the earliest `resetDate`.
Pliki w paczce (3)
- README.md 2 KB
- SKILL.md 4 KB
- usage.py 11 KB
Wersje
W bazie nie ma innych skilli o nazwie show-usage.
Migawka bazy z 13.11.2026 · wersja paczki 4c5496244c7b (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 95status
Sprawdza w subskrypcji Claude Code zużycie limitów: procent wykorzystania oraz czas resetu okna 5-godzinnego i tygodniowego. - 100tokenmeter
Otwiera lokalny panel Tokenmeter, który pokazuje zużycie tokenów, koszty, okna limitów i chybienia cache dla Claude Code i Codex. - 100nuncius
Przekazuje zadania kodowania do Codexa, Cursora lub innego modelu Claude przez Nuncius, na własnych subskrypcjach użytkownika. - 100quota
Pokazuje stan limitów Claude: pięciogodzinną sesję i zużycie tygodniowe z lokalnej pamięci podręcznej. - 100autopilot-usage
Sprawdza pozostały limit każdego narzędzia AI w rejestrze, czasy odnowienia i zużycie tokenów w dniach, miesiącach i latach. - 86quota-axi
Raportuje lokalne okna limitów Claude, Codex, Cursor, GitHub Copilot i innych dostawców przez CLI quota-axi: pozostały zasób, procenty, czasy resetu i tempo zużycia.