PR Lens voor visuele pull-requestreviews

PR Lens is een open-source AI-tool voor pull-requestvisualisatie. De tool zet codewijzigingen om in geanimeerde architectuur- en datastroomdiagrammen en plaatst die in de pull request, zodat reviewers eerst het geheel zien en daarna gerichter de diff kunnen lezen.

Wat doet PR Lens in gewone taal?

Bij een grote pull request moet je tegelijk bestanden, services, aanroepen en verwijderde paden onthouden. PR Lens maakt daarvan een visuele kaart. De architectuurweergave markeert nieuwe, gewijzigde en verwijderde componenten en toont ongewijzigde buren als context. De datastroomweergave laat een echte uitvoeringsvolgorde stap voor stap zien als die aanwezig is. Het is dus een hulpmiddel om een wijziging te begrijpen, geen automatische bug- of beveiligingsscanner.

Hoe de diagrammen code review ondersteunen

Componenten worden gegroepeerd in banen die systeemlagen of grenzen voorstellen. Daardoor ziet een reviewer de mogelijke impact buiten de lijst met aangepaste bestanden. Een geanimeerde stroom helpt bij het volgen van endpoints, wachtrijen, workers en integraties. Op het volledige canvas kun je pannen, zoomen, van thema wisselen en een rondleiding afspelen. De SVG-uitvoer bevat geen JavaScript en wordt deterministisch gemaakt uit een gevalideerd, sterk getypeerd document.

App, Action, CLI of agent skill

De GitHub App vraagt de minste configuratie: kies repositories en de App houdt per pull request één commentaar actueel na iedere push. De GitHub Action draait in je eigen CI met een eigen modelsleutel en ondersteunt Gemini, OpenAI en compatibele endpoints. De CLI biedt lokale stappen voor analyse, validatie, rendering, commentaar en export. De agent skill laat een bestaande coding agent het grafiekdocument schrijven. Gebruik per repository App of Action, zodat er geen dubbele opmerkingen verschijnen.

Een praktisch reviewproces

Installeer de App of voeg de Action toe en open een pull request die klaar is voor review. Bekijk eerst het architectuurdiagram voor grenzen, verwijderingen en gewijzigde componenten. Volg daarna de datastroom en open bij een grote wijziging het canvas. Gebruik de kaart om te bepalen welke bestanden en paden extra aandacht verdienen, maar controleer nog steeds de diff, CI en randgevallen. Zet blijvende naam-, uitsluitings- en groeperingscorrecties in .github/pr-lens.yml in plaats van gegenereerde SVG’s te bewerken.

Kosten, privacy en beperkingen

PR Lens is gratis voor open-sourceprojecten en de repository heeft een MIT-licentie. Bij Action of CLI betaal je alleen je gekozen modelprovider; voor private repositories in de gehoste App publiceert de officiële site geen eenduidige, verifieerbare prijs. De App kloont de PR-head in een eenmalige sandbox, analyseert met Gemini, bewaart grafiekdocumenten en renders in objectopslag en verwijdert de sandbox na afloop. Voor opgeslagen objecten is geen automatische vervaldatum ingesteld en iedereen met een afbeeldingslink kan die render ophalen. Lees bij gevoelige code de officiële uitleg over gegevens en bewaartermijnen en overweeg de lokale CLI of agent skill.

Veelgestelde vragen

Vindt PR Lens bugs of kwetsbaarheden?

Nee. Het visualiseert wat verandert; bugdetectie, securitytests en menselijke beoordeling blijven aparte stappen.

Heb ik een API-sleutel nodig?

Niet voor de gehoste App. Action en CLI gebruiken je eigen providerkey; de skill gebruikt het model van je bestaande coding agent.

Werkt PR Lens met private repositories?

De App kan op geselecteerde private repositories draaien, maar het team moet opslag en linktoegang beoordelen. Lokale modi geven meer controle.

Wat gebeurt er na een nieuwe push?

De App herschrijft het bestaande vaste commentaar met diagrammen van de nieuwste PR-versie.

Officiële bronnen

• Productuitleg en vier uitvoermodi
• Installatie en rechten van de GitHub App
• MIT-broncode, configuratie en issues