PR Lens per visualizzare e revisionare le pull request

PR Lens è uno strumento AI open source per visualizzare le pull request. Converte le modifiche al codice in diagrammi animati di architettura e flusso dei dati pubblicati direttamente nel PR, così il reviewer può capire il cambiamento prima di leggere ogni riga del diff.

Che cosa fa PR Lens, spiegato in modo semplice?

Una pull request grande costringe a tenere a mente file, servizi, chiamate e percorsi rimossi. PR Lens li riunisce in una mappa visuale. La vista architettura evidenzia componenti aggiunti, modificati o eliminati e mantiene visibili quelli invariati che danno contesto. La vista data flow mostra una sequenza operativa quando il cambiamento ne contiene una reale. È quindi un livello di comprensione per la code review, non uno strumento automatico per trovare bug o vulnerabilità.

Perché i diagrammi aiutano nella revisione del codice

I componenti vengono raggruppati in corsie che rappresentano livelli o confini del sistema, rendendo più chiaro il possibile raggio d’impatto. L’animazione è utile per seguire endpoint, code, worker e integrazioni nell’ordine di esecuzione. La canvas a grandezza intera offre zoom, spostamento, tema chiaro o scuro e walkthrough guidato. Gli SVG non contengono JavaScript e sono prodotti in modo deterministico da un documento tipizzato e validato.

Quattro modalità di utilizzo

La GitHub App è la scelta più rapida: selezioni i repository e mantiene un solo commento, aggiornandolo a ogni push. La GitHub Action gira nella tua CI con una chiave modello personale e supporta Gemini, OpenAI o endpoint compatibili. La CLI consente di analizzare, validare, renderizzare, creare il commento ed esportare in locale. Lo skill per coding agent riutilizza il modello dell’agente già aperto. Sullo stesso repository conviene scegliere App oppure Action per non avere due commenti.

Un flusso di revisione pratico

Installa l’App o aggiungi l’Action, quindi apri una pull request pronta per la review. Parti dal diagramma di architettura per individuare confini, componenti nuovi e parti rimosse. Passa al flusso dati per seguire il percorso di esecuzione e usa la canvas per modifiche estese. La mappa aiuta a decidere quali file leggere con maggiore attenzione, ma non sostituisce diff, CI e test dei casi limite. Correggi nomi e raggruppamenti in .github/pr-lens.yml, non negli SVG generati.

Costi, privacy e limiti importanti

PR Lens è gratuito per i progetti open source e il repository è distribuito con licenza MIT. Con Action o CLI paghi soltanto il provider del modello scelto; il sito ufficiale non pubblica un prezzo unico verificabile per l’App ospitata sui repository privati. L’App clona il commit del PR in una sandbox monouso, usa Gemini, salva documenti grafo e rendering in object storage e cancella la sandbox alla fine. Gli oggetti salvati non hanno una scadenza automatica impostata dall’applicazione e chi possiede il link al rendering può scaricare l’immagine. Per codice sensibile consulta la spiegazione ufficiale su dati e conservazione e valuta CLI o agent skill locali.

Domande frequenti

PR Lens trova bug o problemi di sicurezza?

No. Visualizza struttura e flusso del cambiamento; analisi statica, strumenti di sicurezza e review umana restano separati.

Serve una chiave API?

Non per l’App ospitata. Action e CLI usano la tua chiave; lo skill sfrutta il modello del coding agent esistente.

Funziona con repository privati?

L’App può operare sui repository privati selezionati, ma il team deve valutare archiviazione e accesso tramite link. Le modalità locali offrono più controllo.

Che cosa accade dopo un altro push?

L’App aggiorna il proprio commento persistente con i diagrammi della nuova versione.

Risorse ufficiali

• Panoramica e modalità di PR Lens
• Installazione e permessi della GitHub App
• Codice MIT, configurazione e issue