Widget per KDE Plasma 6 che mostra il residuo della sessione (5h) e il residuo settimanale (7d) di Ollama Cloud, il provider ollama-cloud configurato nel pi agent.

Legge la chiave API da ~/.pi/agent/auth.json (provider ollama-cloud, lo stesso usato dall'estensione pi-ollama-cloud) e interroga l'endpoint non documentato GET https://ollama.com/api/usage. L'API restituisce usage come frazione 0..1 già usata, quindi il residuo è 1 - usage.

Funzionalità

Icona nel pannello + due mini-barre verticali (5h / 7d) colorate in base al residuo: verde ≥ soglia gialla, giallo tra soglia rossa e gialla, rosso sotto la soglia rossa. Click = apre il popup.
Popup con due barre grandi, percentuale residuo/usato, conteggio richieste per modello e costo attività delle ultime 4 settimane.
Countdown di reset con data/ora prevista e tempo mancante (es. "1h 23m" / "6g 14h"). Stima iniziale su finestre 5h/7d, poi calibrato automaticamente quando il dashboard rileva una rigenerazione effettiva della quota. Etichetta "STIMA" finché non calibrato, "RILEVATO" dopo il primo reset osservato.
Aggiornamento automatico ogni N secondi (default 300, come l'estensione pi) + pulsante di refresh manuale.
Configurabile: intervallo di aggiornamento, soglie di colore, visibilità del costo attività e dei conteggi per modello.

File

metadata.json                  metadata del pacchetto (Plasma/Applet)
contents/config/main.xml       schema della configurazione (kcfg)
contents/scripts/usage.sh       backend: legge la key, chiama /api/usage, stampa JSON
contents/ui/main.qml            UI (compact + full representation)
contents/ui/LimitRow.qml        riga di residuo riutilizzabile
contents/ui/configGeneral.qml  pagina di configurazione

Installazione

# dal sorgente
kpackagetool6 --type Plasma/Applet --install /home/enne2/Dev/org.enne2.ollamacloud.usage

# aggiornamento dopo modifiche
kpackagetool6 --type Plasma/Applet --upgrade /home/enne2/Dev/org.enne2.ollamacloud.usage

Poi "Aggiungi widget" → cerca "Ollama Cloud Usage" e trascinalo nel pannello o sul desktop.

Dipendenze

jq e curl (per lo script di backend)
la chiave API di Ollama Cloud in ~/.pi/agent/auth.json sotto ollama-cloud (oppure nella variabile OLLAMA_API_KEY)

Note

L'endpoint /api/usage è non documentato e potrebbe cambiare o sparire: lo script gestisce i casi 404/401/429/5xx restituendo un JSON di errore che il plasmoide mostra in modo leggibile.
La chiave API non viene mai stampata né passata come argomento del processo.