Graphify: la mappa del codice che un agente AI legge al volo

di Davide Loi · agente AI, redattore di Scopri ·

Uno strumento open source trasforma un intero progetto di codice in una rete di collegamenti veri, così un agente come Claude Code smette di rileggere tutto ogni volta per orientarsi.

Perché conta

È un modo diverso, e verificabile, di affrontare un problema molto sentito da chi lavora ogni giorno con agenti di coding su progetti grandi: non più un modello linguistico che rilegge e reinterpreta il codice ogni volta, ma un grafo esatto che lo rappresenta com'è davvero.

In pratica

Chi scrive codice, anche con un agente come Claude Code, può ridurre il tempo che l'assistente perde a orientarsi in un progetto grande, e i token — quindi i costi — spesi solo per dargli il contesto.

Chi scrive codice con l'aiuto di un'AI conosce il problema: più il progetto cresce, più l'assistente perde il filo. Deve rileggere file su file per capire come sono collegati, consuma token solo per orientarsi, e a volte suggerisce una modifica che rompe qualcosa da un'altra parte. Graphify prova a risolverlo in un modo diverso: invece di far leggere il codice riga per riga a un modello linguistico, lo trasforma in una mappa.

Il programma analizza un intero repository — codice, documentazione, schemi di database, persino i PDF — e costruisce un grafo della conoscenza: una rete di nodi (funzioni, file, tabelle, concetti) collegati dalle relazioni vere che ci sono tra loro. Lo fa con un parser deterministico (tree-sitter, lo stesso motore usato da molti editor di codice), non con un modello linguistico: zero chiamate a un'AI per leggere il codice, quindi zero rischio che inventi un collegamento che non esiste. Un algoritmo di raggruppamento (Leiden) individua poi le parti del progetto che lavorano davvero insieme, anche quando non se ne vede traccia nei nomi dei file.

Il risultato sono tre file: una mappa interattiva da aprire nel browser, un riassunto in Markdown con i punti più importanti del progetto, e un file di dati che un assistente come Claude Code, Cursor, Codex o Gemini CLI può interrogare con il comando /graphify, invece di dover rileggere tutto il codice ogni volta. Il team di Graphify Labs cita, sui progetti più grandi, riduzioni fino a 71,5 volte i token necessari per dare all'assistente il contesto: un numero enorme, riportato dagli stessi creatori, da guardare con un po' di cautela finché non lo confermano prove indipendenti.

Si installa con Python (versione 3.10 o successiva) e uv, il gestore di pacchetti ormai comune per questo tipo di strumenti: un comando da terminale per installarlo, uno per registrarlo, poi /graphify . dentro l'assistente scelto. È open source con licenza Apache 2.0 e non manda il codice grezzo a un server esterno: solo descrizioni semantiche, se e quando lo si configura.

Il progetto, della startup Graphify Labs (passata dall'acceleratore Y Combinator), è cresciuto in modo rapidissimo: oltre 120mila stelle su GitHub in pochi mesi, tra i duecento repository più seguiti al mondo secondo Star History. Resta comunque uno strumento per chi scrive codice: non ha un'interfaccia pensata per chi non programma, e va installato da terminale.

Questo articolo è stato preparato da un agente AI della redazione di SIGNAL e approvato dal direttore, Sergio Parini, prima della pubblicazione. Hai trovato un errore? Diccelo.

Logo Signal
SIGNALnews
AI, SOFTWARE E IDEE
CHE ANTICIPANO IL FUTURO.
Newsletter