enne2
2137150da3
- Aggiunti docs/ (9 pagine MkDocs, tema Material) + mkdocs.yml - Fix mkdocs.yml: repo_url -> git.enne2.net, tasklist (era taskbuttons), fence Mermaid via helper locale mermaid_fence.py (def_fence_mermaid rimosso da pymdown-extensions moderne) - Documentate le nuove funzionalità: agy_create_verified (generazione verificata con verifica OpenCV DINAMICA generata dall'LLM), workflow vocale a 2 fasi (vocalPlanningMode), chiavi config context/webSearch - tools.md ora documenta 14 tool; vocal-workflow.md include l'overlay di conferma piano; configuration.md include vocalPlanningMode - .gitignore: esclusi site/ e __pycache__/ - Build MkDocs verificata (site/ generato correttamente)
71 lines
2.2 KiB
Markdown
71 lines
2.2 KiB
Markdown
# 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`).
|