PR Lens für visuelle Pull-Request-Reviews

PR Lens ist ein quelloffenes KI-Werkzeug zur Visualisierung von Pull Requests. Es übersetzt Codeänderungen in animierte Architektur- und Datenflussdiagramme und bringt sie direkt in die GitHub-Diskussion, damit Reviewer zuerst den Zusammenhang und danach die entscheidenden Diff-Stellen lesen können.

Was macht PR Lens – einfach erklärt?

Statt zwölf geänderte Dateien gedanklich zu einem System zusammenzubauen, zeigt PR Lens eine Karte der Änderung. Die Architekturansicht markiert neue, geänderte und entfernte Komponenten und lässt unveränderte Nachbarn als Kontext stehen. Die Datenflussansicht stellt einen Ablauf Schritt für Schritt dar, sofern der Pull Request einen sinnvollen Ablauf enthält. Das Werkzeug erklärt also die Struktur einer Änderung; es sucht nicht selbstständig nach Bugs oder Sicherheitslücken.

So unterstützt die Visualisierung das Code Review

Komponenten werden in fachlich verständlichen Bahnen gruppiert, sodass Abhängigkeiten und der mögliche Wirkungsbereich sichtbar werden. Bei API-, Queue- oder Worker-Änderungen hilft der animierte Datenfluss, den neuen Pfad in der richtigen Reihenfolge nachzuvollziehen. Für große Änderungen gibt es eine Leinwand mit Zoom, Verschieben, hellem oder dunklem Thema und geführtem Rundgang. Die SVG-Ausgabe enthält kein JavaScript und wird aus einem validierten, typisierten Dokument deterministisch erzeugt.

GitHub App, Action, CLI oder Agent Skill

Die GitHub App ist für Teams gedacht, die möglichst wenig einrichten möchten: Repository auswählen, Pull Request öffnen, und ein einzelner Kommentar wird bei jedem Push aktualisiert. Die GitHub Action läuft in der eigenen CI mit eigenem Modellschlüssel und unterstützt Gemini, OpenAI sowie kompatible Endpunkte. Die CLI trennt Analyse, Validierung und Rendering für lokale Abläufe. Der Agent Skill lässt einen bereits verwendeten Coding-Agenten das Diagrammdokument schreiben. App und Action sollten nicht gleichzeitig im selben Repository laufen, sonst entstehen zwei Kommentare.

Ein sinnvoller Ablauf für Reviewer

Nach der Installation beginnt man mit der Architekturansicht und prüft, welche Grenzen, Dienste oder entfernten Pfade betroffen sind. Danach zeigt der Datenfluss, wie eine Anfrage oder Verarbeitung durch das System läuft. Bei Bedarf öffnet man die große Leinwand und folgt dem Walkthrough. Anschließend werden genau die relevanten Dateien gelesen, CI-Ergebnisse geprüft und Randfälle getestet. Falsche Benennungen oder Gruppierungen werden dauerhaft über .github/pr-lens.yml korrigiert, nicht direkt im erzeugten SVG.

Kosten, Datenschutz und Grenzen

Für Open-Source-Projekte ist PR Lens kostenlos; Quellcode, Renderer, CLI und Action stehen unter der MIT-Lizenz. Bei Action oder CLI fallen nur die Kosten des selbst gewählten Modellanbieters an. Einen verifizierten Einheitspreis für private Repositories der gehosteten App veröffentlicht die offizielle Seite nicht. Die App analysiert den PR-Stand in einer Einweg-Sandbox, speichert Graphdokumente und Renderings in Objektspeicher und löscht die Sandbox nach dem Lauf. Für gespeicherte Objekte ist laut Anbieter kein automatisches Ablaufdatum gesetzt; außerdem kann ein Bild über seinen Link abrufbar sein. Vor privaten Repositories sollte deshalb die offizielle Erklärung zur Datenverarbeitung geprüft werden.

Häufige Fragen

Findet PR Lens Fehler im Code?

Nein. PR Lens visualisiert Struktur und Ablauf. Fehleranalyse, Security-Checks und menschliches Review bleiben separate Aufgaben.

Brauche ich einen API-Schlüssel?

Für die gehostete App nicht. Action und CLI verwenden den eigenen Provider-Schlüssel; der Agent Skill nutzt das Modell des vorhandenen Coding-Agenten.

Funktioniert PR Lens lokal?

Ja. CLI und Agent Skill können den Diff lokal verarbeiten und die Ergebnisse im Arbeitsverzeichnis ablegen, ohne den gehosteten PR-Lens-Dienst zu verwenden.

Was passiert nach einem weiteren Push?

Die App überschreibt ihren bestehenden Sticky-Kommentar mit den Diagrammen des aktuellen PR-Stands.

Offizielle Ressourcen

• Produktüberblick und Betriebsarten
• Installation und Berechtigungen der GitHub App
• Quellcode, Konfiguration und Issues auf GitHub