# Comandi Slash & Scorciatoie da Tastiera

`agy-pi` mette a disposizione un ricco set di comandi slash interattivi e scorciatoie globali per interagire con l'estensione direttamente dal terminale di `pi`.

---

## Comandi Slash (Slash Commands)

### Gestione Conversazione agy

| Comando | Descrizione | Sintassi / Esempio |
|---|---|---|
| `/agy` | Invia un prompt diretto al subagent `agy` | `/agy Spiega la teoria della relatività` |
| `/agy:new` | Forza la creazione di una nuova conversazione pulita | `/agy:new` |
| `/agy:list` | Mostra l'ID della conversazione agy attiva | `/agy:list` |
| `/agy:reset` | Azzera l'ID conversazione salvato in locale | `/agy:reset` |

---

### Configurazione & Diagnostica TUI

#### `/agy:config`
Gestisce le opzioni di configurazione salvate in `~/.config/agy-pi/config.json`.

- `/agy:config`: Mostra l'elenco completo di tutte le opzioni con i valori attuali e le descrizioni.
- `/agy:config get <chiave>`: Stampa il valore di una singola chiave.
- `/agy:config set <chiave> <valore>`: Modifica il valore di una chiave e salva su disco.
- `/agy:config reset`: Ripristina le impostazioni predefinite di fabbrica.

#### `/agy:key` (Dialog TUI Overlay)
Apre una finestra di dialogo grafica in sovrimpressione nel terminale (`pi-tui` overlay) per inserire o modificare la chiave API Gemini:

```
┌────────────────────────────────────────────────────────┐
│ 🔑 Chiave API Gemini                                   │
│ Attuale: AIza...yfDY                                   │
│                                                        │
│ Nuova chiave: •••••••••••••••••••••••••••••••••••••    │
│                                                        │
│ Digita la chiave • Enter conferma • Esc annulla        │
└────────────────────────────────────────────────────────┘
```
- Input mascherato per prevenire il leak della chiave sul terminale o nella cronologia.
- Salva contemporaneamente la chiave in `~/.config/agy-pi/config.json` e in `~/.agy-chat/gemini-key` (permessi `0600`).

#### `/agy:status` (Diagnostica TUI Overlay)
Mostra una dashboard grafica centrata con lo stato di salute dell'estensione:

```
┌────────────────────────────────────────────────────────┐
│ 📊 Stato agy-pi                                        │
│                                                        │
│ Binario agy: trovato /home/enne2/.local/bin/agy        │
│ Versione: agy version 1.4.2                            │
│ Chiave Gemini: ✅ valida                               │
│ Chiave (mask): AIza...yfDY                             │
│ Modello attivo: Gemini 3.1 Pro (High)                  │
│ Backend STT: gemini                                    │
│ Notifiche TTS: true                                    │
│                                                        │
│ Ultimo errore: (nessuno)                               │
│                                                        │
│ Enter o Esc per chiudere                               │
└────────────────────────────────────────────────────────┘
```

---

### Registrazione Vocale & TTS

| Comando | Descrizione |
|---|---|
| `/agy:record` | Avvia o ferma la registrazione vocale (equivalente al tasto **F12**). |
| `/agy:record:stop` | Ferma la registrazione attiva ed elabora l'audio. |
| `/agy:record:cancel` | Annulla la registrazione corrente senza inviare prompt. |
| `/agy:speak <testo>` | Sintetizza ed esegue l'audio del testo specificato via Gemini TTS. |
| `/agy:vocal [on\|off\|status]` | Attiva (`on`), disattiva (`off`) o mostra lo stato (`status`) del feedback vocale automatico TTS. |

---

## Scorciatoie da Tastiera (Keybindings)

### Tasto `F12` — Registrazione Vocale Toggle
- **Primo tocco (`F12`)**: Avvia la registrazione audio tramite `ffmpeg`, riproduce il suono sci-fi *Power Up* e mostra la barra di stato live `🔴 REGISTRAZIONE... MM:SS / MM:SS`.
- **Secondo tocco (`F12`)**: Interrompe la registrazione, riproduce il suono *Deactivate*, ottimizza l'audio (soppressione silenzio), invia la traccia a Gemini per la trascrizione e trasmette il prompt risultante a `pi`.

### Tasto `Esc` / `Escape` — Annullamento Registrazione
- Durante una registrazione audio attiva, premere `Esc` o `Escape` abortisce immediatamente il processo `ffmpeg`, rimuove il file temporaneo, riproduce il tono acustico di cancellazione e cancella l'indicatore di stato.