feat: initial commit for Antigravity Usage Plasmoid (Plasma 6)

README.md

@@ -0,0 +1,38 @@
+# Antigravity Usage Plasmoid (`org.enne2.antigravity.usage`)
+
+Widget desktop per **KDE Plasma 6** che visualizza in tempo reale le quote di utilizzo e i countdown di reset dei modelli disponibili tramite Google CloudCode PA (Antigravity):
+
+- **Gemini 3.x** (Gemini 3.1 Pro, Gemini 3.5/3.6/3.7 Flash)
+- **Claude 4.6** (Claude Sonnet 4.6, Claude Opus 4.6 Thinking)
+- **GPT-OSS** (GPT-OSS 120B Medium)
+
+---
+
+## Caratteristiche
+
+- **3 card di monitoraggio**: barra percentuale residua, percentuale usata e countdown preciso al reset della quota.
+- **Autenticazione OAuth e Refresh automatico**: legge il token da `~/.gemini/antigravity-cli/antigravity-oauth-token` ed esegue il refresh OAuth se necessario senza interruzione.
+- **Colori adattivi**: soglie configurabili per avviso (giallo) e critico (rosso), con accento cyberpunk indaco/viola.
+- **Formato Desktop**: progettato per la griglia desktop (224×224 px), integrabile a fianco dei widget OpenAI Codex e Ollama Cloud.
+
+---
+
+## Installazione
+
+```bash
+# Packaging
+tar -czvf dist/org.enne2.antigravity.usage.tar.gz -C . \
+  metadata.json contents/
+
+# Installazione Plasma 6
+kpackagetool6 -t Plasma/Applet --install dist/org.enne2.antigravity.usage.tar.gz
+
+# Oppure aggiornamento
+kpackagetool6 -t Plasma/Applet --upgrade dist/org.enne2.antigravity.usage.tar.gz
+```
+
+---
+
+## Licenza
+
+GPL-3.0