README: documentata registrazione F12 con Gemini API

README.md

@@ -29,6 +29,24 @@ conversazioni di ragionamento multi-turno.
 
 L'agente (pi) decide autonomamente quale strumento usare in base al task richiesto.
 
+## Registrazione microfono (F12)
+
+Premi **F12** per avviare/fermare la registrazione dal microfono (max 2 min).
+Il flusso: registra → taglia il silenzio → **trascrive con la Gemini API diretta**
+(`gemini-3.5-flash`, veloce e affidabile — agy CLI non supporta file audio) →
+interpreta con Gemini usando il contesto della conversazione → inserisce il
+risultato come prompt su pi.
+
+**Requisito**: la key Gemini API in `~/.agy-chat/gemini-key` (chmod 600) o nella
+variabile d'ambiente `GEMINI_API_KEY`.
+
+```bash
+# una volta sola
+echo "LA_TUA_KEY" > ~/.agy-chat/gemini-key && chmod 600 ~/.agy-chat/gemini-key
+```
+
+Comandi: `/agy:record` (toggle), `/agy:record:stop` (ferma).
+
 ## Installazione
 
 Requisito: `agy` installato e autenticato (una volta: `agy`, poi login OAuth nel browser).