Files

T

enne2 2137150da3 docs: documentazione MkDocs completa + fix build + verifica OpenCV dinamica

- 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)

2026-08-11 00:47:23 +02:00

2.2 KiB

Raw Blame History

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

./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

./bin/agy-chat.sh "Spiegami la differenza tra REST e GraphQL"

2. Continuare la Conversazione (Multi-Turno)

./bin/agy-chat.sh "Puoi fare un esempio in TypeScript per la risposta precedente?"

3. Forzare una Nuova Conversazione con Modello Specifico

./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

# 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).

2.2 KiB Raw Blame History

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