---
name: usage
description: >
  Show Ollama Cloud credit/usage spent via the ollama.com usage API.
  Triggers on: "/usage", "kolik kreditu", "kolik mam vycerpano",
  "ollama usage", "spotreba ollama", "credits".
---

# Usage

Zobrazí spotřebu kreditů na Ollama Cloud pro aktuální API klíč.

## Spuštění

```bash
uv run skills/usage/scripts/ollama_usage.py
```

Skript čte `OLLAMA_API_KEY` z `workspace/.env` (vytvořeného uživatelem).
Pokud chybí nebo klíč nefunguje (401/403), řekni to uživateli — nescrapuj web.

## Výstup

Text v češtině, přesně tento formát:

- `Session: <value> %, resets in X hours — <model> (<req count>), …`
- `Weekly:  <value> %, resets in Y days — <model> (<req count>), …`
- `Modely (počet požadavků, weekly okno):` — seznam modelů s requesty

## Reset časy — odvození, ne API

`/api/usage` **neobsahuje reset timestamps** (ty existují jen v HTML UI).
Skript je počítá: session = do další celé hodiny UTC (dashboard ukazuje
„Resets in 1 hour"), weekly = do nejbližšího pondělí 00:00 UTC.
Důvod: session usage šel v testu nahoru během pár minut (rolling okno),
weekly se mění pomalu, konzistentní s hodinovým/týdenním oknem.
Kdyby se ukázalo, že okno není kalendářové, uprav `until_next_*`.

## Poznámky

- Endpoint: `GET https://ollama.com/api/usage`, hlavička
  `Authorization: Bearer <key>` (ověřeno 2026-09, issue #15132 je zastaralá).
- `limits.*.usage` je zlomek limitu plánu (× 100 = % jako na dashboardu).
- `activity.cost` u Pro plánu vrací $0.00000 — nefunkční, ve výstupu vynechán.
- Klíč z `~/.ollama/id_ed25519` nefunguje — jen API key z ollama.com.