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

# 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:

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

README.md

agy-pi