Agent Quest 0.3.0: dove finisce il contesto dei tuoi agenti?

Dal villaggio al contesto della sessione

Agent Quest rappresenta le sessioni locali di Claude Code e Codex come personaggi in un villaggio. Con la versione 0.3.0, pubblicata su GitHub il 15 ottobre 2026, alla vista delle attività si aggiungono strumenti per capire meglio che cosa occupa la conversazione e come viene distribuito il lavoro.

La scalabilità passa anche dalla gestione del contesto. Quando il lavoro viene distribuito tra più agenti, ogni sessione ha una propria finestra e produce risultati che possono tornare al principale. Agent Quest rende visibile questa distribuzione: aiuta a individuare conversazioni vicine al limite, istruzioni caricate ripetutamente e risultati da esaminare. Questi dati possono guidare scelte su skill, strumenti e delega; l’app osserva il lavoro e non modifica automaticamente il contesto o la capacità di calcolo dei modelli.

La novità più immediata è la barra del contesto sopra ogni personaggio. Nel pannello di dettaglio trovi In use, il picco raggiunto e il numero di compattazioni. La voce Ctx nella barra superiore evidenzia la conversazione principale più vicina al limite e permette di confrontare gli agenti principali attivi. Un avviso opzionale segnala il raggiungimento dell’85%; barre e avviso si possono disattivare nelle impostazioni.

Il contesto in uso descrive lo spazio occupato nella finestra della conversazione. Il totale dei token elaborati nel corso della sessione è un’altra misura: può crescere attraverso molti turni e non va letto come la percentuale attualmente occupata.

Skill installate e skill caricate: la differenza che conta

Il nuovo pannello Skills & Plugins raccoglie le skill rilevate nelle sessioni selezionate, il numero di caricamenti e una stima dei token delle istruzioni caricate. Puoi osservare gli agenti live oppure estendere l’ambito con All. La vista del singolo personaggio riporta invece i dati della sua sessione.

L’inventario delle skill si aggiorna anche nella vista aperta: quando la scansione periodica rileva nuove skill o plugin, il server invia i cambiamenti senza richiedere un refresh della pagina.

Nello screenshot, cinque skill caricate valgono circa 15,7 mila token. L’inventario di Claude Code contiene 256 skill: circa 873,4 mila token se venissero caricate tutte insieme. Questa seconda cifra è un confronto ipotetico con l’inventario rilevato, non contesto già consumato. Avere molte skill installate non significa averne inserito tutte le istruzioni in ogni conversazione.

I numeri contrassegnati da ~ sono stime basate sui caratteri divisi per quattro. Aiutano a individuare istruzioni grandi o caricamenti da esaminare, ma non costituiscono un conteggio esatto del tokenizer. Anche il totale delle skill caricate non descrive tutto il contesto: restano messaggi, letture, risultati e altre istruzioni.

Una skill lunga può essere utile per un compito complesso. La domanda pratica è se quelle istruzioni servivano al lavoro svolto, se sono state caricate più volte e se una versione più breve avrebbe fornito lo stesso aiuto.

Plugin e MCP: quanto materiale restituiscono?

Per i plugin e i server MCP, Agent Quest mostra le chiamate rilevate e una stima dei token dei risultati. Questo aiuta a notare strumenti che restituiscono molto testo: una ricerca più mirata, un filtro o una pagina di risultati più piccola potrebbero ridurne l’impatto sulla conversazione.

Nell’esempio allegato le chiamate sono zero nell’ambito selezionato. Non significa che non esistano plugin installati, né misura il costo complessivo delle loro definizioni. La tabella riguarda le chiamate e le risposte osservate nei log supportati.

Capire che cosa resta ai subagenti

La delega diventa più leggibile anche nel villaggio. I subagenti sono più piccoli, riprendono il colore del principale e compaiono sotto di lui nella Party Bar. Il badge SUBAGENT e il collegamento al genitore rendono riconoscibili le diverse sessioni.

Nel pannello del principale, Delegation confronta i picchi di contesto dei subagenti con la stima del materiale restituito. Nell’immagine del principale compaiono circa 280,1 mila token nella voce Processed by them, circa 269 token restituiti e circa 279,8 mila rimasti fuori dalla sua conversazione.

In questa versione, “Processed by them” è calcolato come somma dei picchi di contesto dei figli; “Kept out of this context” è la differenza, mai negativa, rispetto ai token restituiti. È un’indicazione dell’isolamento del lavoro delegato, non una misura dei token totali elaborati o del denaro risparmiato.

Le due schermate sono fotografie di momenti diversi: nel dettaglio del subagente il picco è 83,8 mila token. Non vanno sommate o trattate come una fotografia sincronizzata. Un risultato breve può alleggerire il contesto principale, ma la sua utilità va verificata rispetto all’incarico affidato.

Esportare il report e farlo leggere a un’altra AI

I pulsanti Copy MD, .md e .json permettono di copiare o scaricare un riepilogo dal pannello del personaggio. Nel pannello collettivo trovi anche Copy Markdown per l’ambito selezionato.

Il Markdown include dati della sessione, contesto, attività, skill, plugin, delega, ultimo messaggio e domande per la revisione. Il JSON offre dati strutturati e conteggi delle chiamate, senza gli input grezzi degli strumenti. È un report dello stato osservato, non l’intera trascrizione: alcuni testi nel Markdown sono troncati e i conteggi aggregati non permettono sempre di ricostruire una sequenza di letture.

1. Apri il personaggio da esaminare oppure scegli l’ambito in Skills & Plugins.
2. Copia il Markdown o scarica il formato che preferisci.
3. Rileggi il file: può includere percorsi locali, testo del task e ultimo messaggio. Rimuovi ciò che non vuoi condividere.
4. Fornisci il report all’AI insieme all’obiettivo originale e, se necessario, al risultato da verificare.

Puoi accompagnarlo con questa richiesta:

Analizza questo report di Agent Quest rispetto all’obiettivo della sessione. Distingui dati osservati, stime e informazioni mancanti. Individua caricamenti di skill o risultati di plugin che meritano una verifica, senza considerarli automaticamente sprechi. Valuta se la delega e la dimensione dei risultati restituiti erano appropriate. Non dedurre risparmi economici né successo del compito dai soli token. Proponi tre miglioramenti concreti e indica quali prove aggiuntive servono.

Il report rende più semplice iniziare una revisione. Per stabilire se il lavoro è riuscito servono anche il risultato prodotto, gli eventuali test e i requisiti del compito.

Le altre novità e come aggiornare

La 0.3.0 aggiunge il supporto al formato di log item_completed di Codex 0.160 e successivi, mantenendo quello precedente. Riconosce inoltre i subagenti Codex e il loro principale, le letture di SKILL.md e le chiamate MCP. Il feed delle attività introduce le righe Skill e Compact e un filtro dedicato alle skill.

La finestra di Codex viene letta dai dati che Codex stesso registra. Per Claude Code, Agent Quest 0.3.0 usa configurazione e indizi: suffisso [1m], inferenza a 1 milione oltre 200 mila token, oppure valore predefinito di 200 mila. È disponibile l’override AGENT_QUEST_CLAUDE_CONTEXT_WINDOW. Questi sono criteri di Agent Quest, non una garanzia della capacità di qualsiasi modello: controlla anche la provenienza del valore nel pannello.

Se usi una copia installata che segue origin/main e dispone del comando dedicato, esegui agentquest update e riavvia Agent Quest. Il comando aggiorna alla versione presente su main, che può avanzare oltre la 0.3.0. Per una versione precisa o un checkout di sviluppo, segui le istruzioni e i tag della repository.