Przejdź do treści
Biblioteka skilli
AI i agenci · Analiza

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.

Licencja
MIT
Ostatnia zmiana repozytorium
22.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 22.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

  1. Tools
  2. First run
  3. Every run
  4. JSON
  5. Changing usage.py
Sekcje z nagłówków SKILL.md, w oryginale · 69 linii, 552 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.