
Dal prompt in Xcode al villaggio
Avvia Agent Quest sullo stesso Mac e con lo stesso account utente di Xcode. Dentro Xcode scegli Claude Agent o Codex, invia un prompt e lascia lavorare l’agente: la dashboard rileva i log locali compatibili e mostra la sessione, normalmente entro il ciclo di controllo di 2–3 secondi.
Le letture e le ricerche portano l’eroe alla Library, le modifiche alla Forge, build e test all’Arena, la diagnostica dei problemi all’Alchemist. Puoi seguire queste sessioni insieme agli agenti avviati fuori da Xcode.
Agent Quest resta una dashboard open source eseguita con Bun nel browser. Legge le attività disponibili nei log: non controlla Xcode, non verifica l’accesso dell’agente al suo account e non copre automaticamente ogni provider di chat dell’IDE.
Un badge Xcode e il nome del progetto
La provenienza della sessione è visibile con il badge Xcode nella mappa, nell’elenco degli agenti, nei dettagli e nelle attività. Il badge compare anche quando nel villaggio c’è un solo provider.
Le sessioni principali usano un nome ricavato dal percorso del progetto, mentre il profilo distingue Xcode · Claude e Xcode · Codex. Il modello rimane indicato separatamente. Un agente esterno che usa gli strumenti di Xcode conserva invece l’identità della propria sessione terminale o app.

Aggiornamenti più affidabili mentre gli agenti lavorano
I log vengono scritti mentre il lavoro è in corso. La 0.4.0 attende che una riga sia completa prima di leggerla e riconosce le chiamate Codex che compaiono sia all’inizio sia al completamento, evitando di contarle due volte.
Claude avviato da Xcode viene seguito attraverso la sua attività nei log, senza dipendere dai processi registrati dalle sessioni terminale. Anche le cartelle create dopo l’avvio vengono scoperte automaticamente: se Xcode genera i log soltanto al primo prompt, non serve riavviare Agent Quest per rilevarle.
Se una sessione non compare, invia un nuovo prompt e verifica che i log siano presenti e leggibili nello stesso account macOS. I file non aggiornati da più di tre ore vengono saltati all’avvio e rilevati quando riprendono a scrivere. I percorsi e gli altri controlli sono riportati nel README del progetto.
Un avvio più chiaro
Una schermata di caricamento appare subito e accompagna il caricamento delle risorse, la connessione e la preparazione della mappa. Il villaggio e i pannelli vengono mostrati quando il primo fotogramma completo è pronto, evitando di anticipare l’interfaccia mentre la scena si sta ancora costruendo.
Se la preparazione del villaggio non riesce, compare un messaggio utile. Il caricamento rispetta anche la preferenza di sistema per il movimento ridotto.
Come aggiornare alla 0.4.0
Ferma Agent Quest con Ctrl+C nel terminale, poi esegui:
agentquest update
agentquest
Per un’installazione manuale, dalla cartella del progetto:
git pull --ff-only && bun install
bun start
Ricarica la dashboard dopo il riavvio. Questi comandi seguono il ramo main, che può includere modifiche successive alla release. Se Git segnala conflitti, conserva e risolvi le modifiche locali prima di continuare.
La 0.3.1 può segnalare la nuova release stabile dalla dashboard. Restano disponibili il monitoraggio del contesto, skill e plugin, le famiglie di subagenti, i report e l’editor della mappa.
Fonte: Agent Quest v0.4.0
