From f48e1c2f6764e6a8c1706c9432331c9a4d02e462 Mon Sep 17 00:00:00 2001
From: dev <dev@local>
Date: Sun, 9 Aug 2026 22:28:47 +0200
Subject: [PATCH] README: documentata registrazione F12 con Gemini API

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

diff --git a/README.md b/README.md
index 5f2290f..ea012e3 100644
--- a/README.md
+++ b/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).