# OpenAI Codex Usage — plasmoide KDE Plasma 6

[![Gitea](https://img.shields.io/badge/Gitea-enne2%2Fkde--codex--dashboard-blue?logo=gitea)](https://git.enne2.net/enne2/kde-codex-dashboard)

Widget desktop 224×224 per KDE Plasma 6 che mostra il **residuo a doppia finestra** (Settimanale 7D e Finestra 5 ore) di [OpenAI Codex](https://openai.com/codex), autenticato via OAuth (profilo ChatGPT).

Legge il token OAuth da `~/.pi/agent/auth.json` (provider `openai-codex` configurato nel [pi agent](https://pi.dev)) e interroga l'endpoint `GET https://chatgpt.com/backend-api/wham/usage`.

## Funzionalità

- **Piano**: Plus / Free / Team visibile nell'header.
- **Doppia Finestra Rate Limit**:
  - **Finestra Settimanale (7D)** con barra di avanzamento e countdown esatto di reset.
  - **Finestra 5 Ore (5H)** con barra di avanzamento e countdown esatto di reset.
- **Crediti di Reset**: badge con conteggio dei crediti di reset gratuiti disponibili (`rate_limit_reset_credits`).
- **Stato limiti**: indicatore visivo di blocco attivo (`limit_reached` o `spend_control.reached`).
- **Aggiornamento automatico** configurabile + pulsante di refresh manuale.

## File

```
metadata.json                  metadata del pacchetto (Plasma/Applet)
contents/config/main.xml       schema della configurazione (kcfg)
contents/scripts/usage.sh      backend: token OAuth, chiama wham/usage, stampa JSON
contents/ui/main.qml           UI (dashboard 224×224)
contents/ui/configGeneral.qml  pagina di configurazione
```

## Dipendenze

- `jq` e `curl` (per lo script di backend)
- il token OAuth di OpenAI Codex in `~/.pi/agent/auth.json` sotto `openai-codex` (impostato da pi con `/login`)