# Wrapper Script CLI (`bin/agy-chat.sh`)

Oltre all'estensione TypeScript per `pi`, il repository include lo script di utilità Bash standalone **`bin/agy-chat.sh`**.

---

## Scopo dello Script

Lo script permette di eseguire conversazioni multi-turno con `agy` direttamente dal terminale shell, mantenendo la persistenza dell'ID conversazione in `~/.agy-chat/conversation_id` esattamente come fa l'estensione Node.js.

---

## Sintassi & Parametri

```bash
./bin/agy-chat.sh [OPZIONI] "PROMPT"
```

### Tabella dei Parametri

| Opzione | Descrizione |
|---|---|
| `"prompt"` | Il prompt o task da inviare ad `agy` |
| `--new` | Forza l'avvio di una nuova conversazione (ignora l'ID salvato) |
| `--reset` | Elimina il file di stato `conversation_id` ed esce |
| `--id` | Stampa l'ID della conversazione attualmente attiva ed esce |
| `--list` | Elenca le conversazioni recenti salvate nel database SQLite di `agy` |
| `--resume <id>` | Riprende una conversazione specifica indicando il suo ID |
| `--model <nome>` | Specifica il modello LLM (es. `--model "Gemini 3.1 Pro (High)"`) |
| `--effort <livello>` | Livello di reasoning: `low` \| `medium` \| `high` |
| `--add-dir <path>` | Aggiunge una directory al contesto di lavoro di `agy` |
| `--yolo` | Passa il flag `--dangerously-skip-permissions` ad `agy` |

---

## Esempi d'Uso

### 1. Avviare o Continuare una Conversazione
```bash
./bin/agy-chat.sh "Spiegami la differenza tra REST e GraphQL"
```

### 2. Continuare la Conversazione (Multi-Turno)
```bash
./bin/agy-chat.sh "Puoi fare un esempio in TypeScript per la risposta precedente?"
```

### 3. Forzare una Nuova Conversazione con Modello Specifico
```bash
./bin/agy-chat.sh --new --model "Gemini 3.1 Pro (High)" --effort high "Disegna l'architettura di un sistema a microservizi"
```

### 4. Gestione dello Stato
```bash
# Mostra l'ID attivo
./bin/agy-chat.sh --id

# Elenca tutte le conversazioni salvate
./bin/agy-chat.sh --list

# Ripristina lo stato
./bin/agy-chat.sh --reset
```

---

## Variabili d'Ambiente Supportate

- **`AGY_CHAT_STATE`**: Directory del file di stato (default: `~/.agy-chat`).
- **`AGY_BIN`**: Percorso dell'eseguibile `agy` (default: `agy` presente nel `PATH`).