kde-codex-dashboard/README.md

OpenAI Codex Usage — plasmoide KDE Plasma 6

Widget desktop 224×224 per KDE Plasma 6 che mostra il residuo a doppia finestra (Settimanale 7D e Finestra 5 ore) di OpenAI Codex, autenticato via OAuth (profilo ChatGPT).

Legge il token OAuth da ~/.pi/agent/auth.json (provider openai-codex configurato nel pi agent) 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)