From 139124a76fcfa747e83d6df6e0e635f6a34f8ee6 Mon Sep 17 00:00:00 2001
From: dev <dev@local>
Date: Sun, 9 Aug 2026 23:02:54 +0200
Subject: [PATCH] README: documentato /agy:config

---
 README.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/README.md b/README.md
index a0d3a32..88ab805 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,36 @@ conversazioni di ragionamento multi-turno.
 
 L'agente (pi) decide autonomamente quale strumento usare in base al task richiesto.
 
+## Configurazione persistente (`/agy:config`)
+
+Tutte le impostazioni dell'estensione si gestiscono con il comando `/agy:config`
+(salvate in `~/.config/agy-pi/config.json`, permessi 600):
+
+```
+/agy:config                    # elenca tutte le impostazioni
+/agy:config get <chiave>       # mostra una chiave
+/agy:config set <chiave> <valore>  # imposta una chiave
+/agy:config reset              # ripristina i default
+```
+
+| Chiave | Default | Descrizione |
+|---|---|---|
+| `geminiApiKey` | — | Chiave API Google Gemini (STT/TTS) |
+| `enne2ApiKey` | — | Token per il server proxy ai.enne2.net (opzionale) |
+| `sttBackend` | `gemini` | Backend trascrizione: `gemini` \| `enne2` |
+| `sttUrl` | `https://ai.enne2.net` | URL base backend enne2 |
+| `sttModel` | `gemma4:E4B` | Modello STT backend enne2 |
+| `sttMaxDuration` | `120` | Durata max registrazione (secondi) |
+| `ttsBackend` | `gemini` | Backend TTS: `gemini` \| `enne2` |
+| `ttsNotify` | `true` | Notifiche vocali automatiche |
+| `ttsModel` | `gemini-2.5-flash-preview-tts` | Modello TTS Gemini |
+| `agyBin` | `agy` | Path del binario agy |
+| `agyDefaultModel` | — | Modello predefinito per le chiamate agy |
+| `agyTimeoutMs` | `180000` | Timeout esecuzione agy (ms) |
+
+Le variabili d'ambiente (`GEMINI_API_KEY`, `AGY_STT_BACKEND`, ecc.) hanno
+priorità sul file di config quando impostate.
+
 ## Registrazione microfono (F12)
 
 Premi **F12** per avviare/fermare la registrazione dal microfono (max 2 min).