Aggiunto supporto al motore CLI Antigravity (agy)

docs/INSTALL.md

@@ -1,4 +1,4 @@
-# Installare i motori (Claude Code e Codex)
+# Installare i motori (Claude Code, Codex, Antigravity)
 
 L'app non installa né autentica i motori: lancia quelli che trova nel PATH, già installati e con l'accesso fatto ([ADR-0002](adr/0002-motori-cli-claude-codex-antigravity.md)). Questa pagina spiega come prepararli. Fonti e data di consultazione in fondo.
 
@@ -11,7 +11,7 @@ Il motore va installato **nello stesso ambiente in cui gira l'app**:
 | WSL (anche con `dotnet run`) | nel terminale della distribuzione WSL |
 | Windows (`.exe`) | in Windows (PowerShell), non in WSL |
 
-Dentro WSL il PATH di Windows è visibile (compare `/mnt/c/…`): se in WSL non c'è un `claude` o un `codex`, il comando può risolvere nella versione Windows. Controllalo con `command -v claude` e `command -v codex`.
+Dentro WSL il PATH di Windows è visibile (compare `/mnt/c/…`): se in WSL non c'è un `claude`, `codex` o `agy`, il comando può risolvere nella versione Windows. Controllalo con `command -v claude`, `command -v codex` e `command -v agy`.
 
 ## Claude Code
 
@@ -73,32 +73,50 @@ codex exec --help       # uso non interattivo, usato dall'app
 
 **Problema noto: "requires a newer version of Codex".** Se il modello predefinito del tuo `~/.codex/config.toml` richiede un Codex più recente, `codex exec` fallisce con quell'errore (l'app lo mostra nella chat). Aggiorna con `codex update`, oppure scegli un altro modello nelle Impostazioni dell'app. Controllato su questa macchina il 2026-10-15 con Codex 0.144.3.
 
-## Aggiornare un CLI dall'app
-Nel riquadro Impostazioni, sezione **Aggiornamenti**, l'app controlla da sola, all'avvio e all'apertura del riquadro, se c'è una versione più recente (Claude Code: `downloads.claude.ai`; Codex: release di GitHub): se c'è, la riga dice "Aggiornamento disponibile", il pulsante **Aggiorna** si evidenzia e compare un puntino sul pulsante Impostazioni. Il pulsante esegue `claude update` o `codex update` (controllano e installano solo se c'è una versione nuova). Nulla si aggiorna senza un clic. Se non va a buon fine l'app mostra l'errore e il comando manuale, che dipende da come hai installato il CLI:
+## Antigravity CLI (`agy`)
 
-| Installazione | Claude Code | Codex |
-|---|---|---|
-| npm | `npm install -g @anthropic-ai/claude-code@latest` | `npm install -g @openai/codex@latest` |
-| Homebrew | `brew upgrade claude-code` | `brew upgrade --cask codex` |
-| WinGet | `winget upgrade Anthropic.ClaudeCode` | reinstalla con lo script PowerShell |
-| Nativo / script | `claude update` | `codex update` (o rilancia lo script di installazione) |
+**Requisiti**: Linux x64 (binario nativo ELF) o Windows x64 (eseguibile nativo `.exe`).
+
+**Installazione**: binario nativo distribuito ufficialmente (su Linux collocato in `~/.gemini/bin/agy` o in una cartella inclusa nel PATH; su Windows `agy.exe`).
+
+**Accesso**: autenticazione tramite account Google/Antigravity (`agy` o configurazione di ambiente).
+
+**Verifica**
+```
+agy --version             # stampa la versione, es. 1.4.2
+agy models                # catalogo modelli disponibili
+agy update                # controlla e aggiorna alla versione più recente
+```
+
+**Permessi per la sola lettura non interattiva**: per usare `agy` in modalità non interattiva (`-p`) in sola lettura, nel file `~/.gemini/antigravity-cli/settings.json` deve essere presente la regola `'read_file(*)'` sotto `'permissions.allow'` (altrimenti headless mode nega `read_file` con errore jetski: `a tool required the read_file permission that headless mode cannot prompt for`), mentre scritture e comandi restano negati di default.
+
+## Aggiornare un CLI dall'app
+Nel riquadro Impostazioni, sezione **Aggiornamenti**, l'app controlla da sola, all'avvio e all'apertura del riquadro, se c'è una versione più recente (Claude Code: `downloads.claude.ai`; Codex: release di GitHub; Antigravity: endpoint ufficiale di auto-update): se c'è, la riga dice "Aggiornamento disponibile", il pulsante **Aggiorna** si evidenzia e compare un puntino sul pulsante Impostazioni. Il pulsante esegue `claude update`, `codex update` o `agy update` (controllano e installano solo se c'è una versione nuova). Nulla si aggiorna senza un clic. Se non va a buon fine l'app mostra l'errore e il comando manuale, che dipende da come hai installato il CLI:
+
+| Installazione | Claude Code | Codex | Antigravity |
+|---|---|---|---|
+| npm | `npm install -g @anthropic-ai/claude-code@latest` | `npm install -g @openai/codex@latest` | `agy update` |
+| Homebrew | `brew upgrade claude-code` | `brew upgrade --cask codex` | `brew upgrade agy` |
+| WinGet | `winget upgrade Anthropic.ClaudeCode` | reinstalla con lo script PowerShell | `agy update` |
+| Nativo / script | `claude update` | `codex update` (o rilancia lo script di installazione) | `agy update` |
 
 Dettagli e decisioni: [ADR-0004](adr/0004-aggiornamento-dei-cli.md).
 
 ## Controllo finale per l'app
 Dallo stesso terminale da cui avvii l'app:
 ```
-command -v claude codex          # Linux/WSL; in PowerShell: Get-Command claude, codex
+command -v claude codex agy      # Linux/WSL; in PowerShell: Get-Command claude, codex, agy
 claude -p "rispondi solo: ok"
 codex exec "rispondi solo: ok"
+agy -p "rispondi solo: ok"
 ```
-Se i comandi rispondono, l'app li trova. Se l'app dice "'claude' non trovato nel PATH":
+Se i comandi rispondono, l'app li trova. Se l'app dice che un motore non è trovato nel PATH:
 - apri un nuovo terminale (il PATH si aggiorna solo ai nuovi);
-- controlla che la cartella d'installazione sia nel PATH: per Claude Code nativo e per Codex con script è `~/.local/bin` su Linux/macOS/WSL, `%USERPROFILE%\.local\bin` su Windows (per Claude Code);
+- controlla che la cartella d'installazione sia nel PATH (`~/.local/bin`, `~/.gemini/bin`, o `%USERPROFILE%\.local\bin` su Windows);
 - verifica di non aver installato in un ambiente diverso da quello dell'app (tabella iniziale).
 
 ## Fonti
 - Claude Code: documentazione ufficiale "Advanced setup", consultata il 2026-10-15 (`code.claude.com/docs/en/setup`).
-- Codex: README del repository `github.com/openai/codex`, consultato il 2026-10-15. La pagina openai.com/it-IT/codex/ non era raggiungibile (HTTP 403).
-- Comandi `--version`, `login status`, `auth status` e `exec --help`: provati sulla macchina descritta sopra.
-- Antigravity CLI (`agy`): non ancora trattato, da aggiungere quando verrà integrato.
+- Codex: README del repository `github.com/openai/codex`, consultato il 2026-10-15.
+- Antigravity CLI: binario `agy` verificato in ambiente reale il 2026-10-18.
+- Comandi `--version`, `agy models`, `agy update`: provati sulla macchina descritta sopra.