OpenAI Codex Usage — plasmoide KDE Plasma 6

Widget desktop 224×224 per KDE Plasma 6 che mostra il residuo settimanale 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 (non documentato) GET https://chatgpt.com/backend-api/wham/usage.

Funzionalità

• Piano: Plus / Free / Team visibile nell'header.
• Residuo settimanale con barra di avanzamento e percentuale.
• Countdown esatto al reset (data/ora + giorni/ore/minuti mancanti), direttamente dal campo reset_at della risposta API.
• Crediti: saldo crediti extra (se disponibili).
• Stato limiti: indicatore visivo se 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

Installazione

# da sorgente
kpackagetool6 --type Plasma/Applet --install /home/enne2/Dev/org.enne2.codex.usage

# da archivio
kpackagetool6 --type Plasma/Applet --install dist/org.enne2.codex.usage.tar.gz

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)

Note

• L'endpoint /backend-api/wham/usage è non documentato e potrebbe cambiare.
• Se il token OAuth scade, il plasmoide mostrerà "token scaduto". Riesegui /login in pi (provider openai-codex) per rigenerarlo.