agy-pi: estensione pi per Antigravity CLI (agy) subagent multimodale

2026-08-09 19:57:02 +02:00
commit f12199fd2e
5 changed files with 631 additions and 0 deletions
@@ -0,0 +1,94 @@
+# agy-pi
+
+Estensione per **pi** che integra **Google Antigravity CLI (`agy`)** come subagent multimodale.
+
+Anche se il modello di pi è text-only, questa estensione permette a pi di delegare a agy
+(che usa **Gemini multimodale**) task che richiedono immagini, audio e video, oltre a
+conversazioni di ragionamento multi-turno.
+
+## Capacità
+
+| Capacità | Tool | Esempio |
+|---|---|---|
+| Conversazione multi-turno | `agy` | `agy(prompt="Analizza questo problema...")` |
+| Generazione immagini | `agy` | `agy(prompt="Genera un'immagine di un gatto cyberpunk", mode="image")` |
+| Analisi immagini | `agy` | `agy(prompt="Descrivi l'immagine", filePath="/path/foto.jpg")` |
+| Analisi audio | `agy` | `agy(prompt="Trascrivi l'audio", filePath="/path/voce.wav", yolo=true)` |
+| Analisi video | `agy` | `agy(prompt="Descrivi il video", filePath="/path/clip.mp4", yolo=true)` |
+| Gestione stato conversazione | `agy_conversation` | `agy_conversation(action="id" \| "list" \| "reset")` |
+
+## Installazione
+
+Requisito: `agy` installato e autenticato (una volta: `agy`, poi login OAuth nel browser).
+
+```bash
+# da un repo git
+pi install git:github.com/<tuo-utente>/agy-pi
+
+# oppure da una cartella locale
+pi install /percorso/a/agy-pi
+```
+
+Per provare senza installare:
+
+```bash
+pi -e /percorso/a/agy-pi
+```
+
+## Uso
+
+### Come tool (chiamato automaticamente dal modello)
+
+Quando chiedi a pi di generare un'immagine, analizzare un file, o ragionare insieme a un
+secondo agente, pi può chiamare il tool `agy`. Esempi di prompt:
+
+```
+Genera un'immagine di un paesaggio marziano al tramonto.
+Analizza l'immagine /home/utente/foto.jpg e descrivila.
+Trascrivi il file audio /home/utente/voce.wav.
+Chiedi a agy di ragionare su questo problema e poi confronta la sua risposta con la tua.
+```
+
+### Come comando interattivo
+
+```
+/agy <prompt>        # invia un prompt a agy
+/agy:new             # forza una nuova conversazione
+/agy:list            # mostra la conversazione corrente
+/agy:reset           # azzera lo stato conversazione
+```
+
+## Parametri del tool `agy`
+
+| Parametro | Tipo | Descrizione |
+|---|---|---|
+| `prompt` | string (obbligatorio) | Il task/prompt per agy |
+| `mode` | `chat` \| `image` \| `analyze` | Tipo di operazione (default `chat`) |
+| `model` | string | Modello agy (es. `Gemini 3.1 Pro (High)`, `Claude Opus 4.6 (Thinking)`) |
+| `effort` | `low` \| `medium` \| `high` | Livello di ragionamento |
+| `newConversation` | boolean | Forza una nuova conversazione |
+| `addDir` | string | Cartella da aggiungere al workspace agy |
+| `filePath` | string | File (immagine/audio/video) da analizzare |
+| `yolo` | boolean | `--dangerously-skip-permissions` (necessario per audio/video) |
+
+## Multi-turno
+
+L'estensione mantiene l'ID della conversazione agy in `~/.agy-chat/conversation_id`.
+Ogni chiamata a `agy` continua la conversazione precedente, così agy ricorda i turni
+precedenti (ragionamento multi-shot). Usa `newConversation: true` per ripartire da zero.
+
+## Note di sicurezza
+
+- `yolo: true` auto-approva tutti gli strumenti di agy. Usalo solo in ambienti fidati.
+- Le estensioni pi girano con i permessi completi del sistema. Rivedi il codice prima di
+  installare pacchetti di terze parti.
+
+## Struttura
+
+```
+agy-pi/
+├── package.json          # manifest pi
+├── extensions/index.ts   # estensione (tool + comandi)
+├── bin/agy-chat.sh       # wrapper bash standalone (opzionale)
+└── README.md
+```