Files

33 lines
1.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`)