PR Lens pour visualiser les pull requests

PR Lens est un outil IA open source de visualisation des pull requests. Il transforme les changements de code en diagrammes animés d’architecture et de flux de données, publiés dans la pull request afin que l’équipe voie d’abord la forme du changement, puis lise les lignes importantes.

À quoi sert PR Lens, en termes simples ?

Une grosse pull request oblige à retenir simultanément des fichiers, des services, des appels et des chemins supprimés. PR Lens rassemble ces éléments dans une carte visuelle. La vue architecture signale les composants ajoutés, modifiés ou retirés et conserve les voisins inchangés comme contexte. La vue flux de données déroule une séquence réelle lorsqu’elle existe. L’outil aide à comprendre le changement ; il ne cherche pas automatiquement des bugs ou des failles.

Ce que les diagrammes apportent à la code review

Les composants sont classés dans des couloirs correspondant aux couches ou frontières du système. Le reviewer peut ainsi repérer le rayon d’impact au-delà de la simple liste de fichiers. L’animation aide à suivre un endpoint, une file, un worker ou une intégration dans l’ordre d’exécution. Un canevas plein écran permet de zoomer, déplacer, changer de thème et lancer une visite guidée. Les SVG n’embarquent pas de JavaScript et sont rendus de façon déterministe à partir d’un document typé validé.

App GitHub, Action, CLI ou skill d’agent

L’App GitHub demande le moins de configuration : on sélectionne les dépôts, puis elle maintient un commentaire unique mis à jour après chaque push. L’Action GitHub tourne dans votre CI avec votre propre clé et accepte Gemini, OpenAI ou un endpoint compatible. La CLI sépare l’analyse, la validation, le rendu, le commentaire et l’export pour un usage local. Le skill utilise le modèle de l’agent de code déjà ouvert. Il vaut mieux choisir l’App ou l’Action pour un même dépôt afin d’éviter deux commentaires.

Parcours conseillé pour une revue

Installez l’App ou ajoutez l’Action, puis ouvrez une pull request prête à être relue. Commencez par la vue architecture pour repérer les frontières et les suppressions, puis suivez le flux de données. Ouvrez le canevas pour les changements larges. Servez-vous de cette carte pour cibler les fichiers à examiner, mais vérifiez toujours le diff, la CI et les cas limites. Les corrections de nom, d’exclusion ou de regroupement se placent dans .github/pr-lens.yml plutôt que dans les SVG générés.

Coût, confidentialité et limites

PR Lens est gratuit pour l’open source et son dépôt est sous licence MIT. Avec l’Action ou la CLI, vous payez seulement votre fournisseur de modèle ; le site officiel ne publie pas de tarif unique vérifiable pour l’App hébergée sur les dépôts privés. L’App clone la tête du PR dans une sandbox à usage unique, analyse avec Gemini, conserve les documents de graphe et les rendus dans un stockage objet, puis supprime la sandbox. L’application ne fixe pas d’expiration automatique à ces objets, et toute personne disposant du lien d’une image peut la récupérer. Pour du code sensible, lisez la note officielle sur le traitement et la conservation ou choisissez la CLI locale.

Questions fréquentes

PR Lens détecte-t-il les bugs ou les vulnérabilités ?

Non. Il montre ce que la pull request change ; les outils de détection et le jugement humain restent complémentaires.

Faut-il une clé API ?

Pas pour l’App hébergée. L’Action et la CLI utilisent votre clé ; le skill réutilise le modèle de votre agent de code.

Peut-on l’utiliser avec un dépôt privé ?

Oui pour les dépôts sélectionnés dans l’App, sous réserve d’accepter son modèle de stockage. Les modes locaux offrent davantage de contrôle.

Que se passe-t-il après un nouveau push ?

L’App réécrit son commentaire existant avec les diagrammes du dernier état.

Ressources officielles

• Présentation complète de PR Lens
• Installation et permissions de l’App GitHub
• Code source MIT, configuration et issues