PR Lens para visualizar y revisar pull requests

PR Lens es una herramienta de IA y código abierto para visualizar pull requests. Convierte los cambios de código en diagramas animados de arquitectura y flujo de datos que aparecen dentro del propio PR, de modo que el equipo puede entender el alcance antes de revisar línea por línea.

¿Para qué sirve PR Lens, explicado de forma sencilla?

Un diff grande obliga a recordar archivos, servicios, llamadas y rutas eliminadas al mismo tiempo. PR Lens reúne esa información en un mapa visual. La vista de arquitectura enseña componentes nuevos, modificados, eliminados y elementos sin cambios que aportan contexto. La vista de flujo de datos recorre en orden una solicitud o proceso cuando existe una secuencia real. Su función es facilitar la comprensión del cambio, no detectar errores ni vulnerabilidades automáticamente.

Cómo mejora la revisión de código

Los componentes se agrupan en carriles que representan capas o límites del sistema, lo que ayuda a ver el radio de impacto más allá de la lista de archivos. La animación de flujo resulta útil para seguir endpoints, colas, workers e integraciones. Un lienzo de tamaño completo permite ampliar, desplazar, cambiar de tema y reproducir un recorrido guiado. Los SVG no llevan JavaScript y se generan de forma determinista a partir de un documento tipado y validado.

Cuatro formas de usar PR Lens

La GitHub App es la opción con menos configuración: eliges repositorios y mantiene un único comentario actualizado después de cada push. La GitHub Action se ejecuta en tu CI con tu propia clave y admite Gemini, OpenAI o endpoints compatibles. La CLI permite analizar, validar, renderizar, componer comentarios y exportar de manera local. El skill para agentes aprovecha el modelo del asistente de programación que ya utilizas. Conviene elegir App o Action por repositorio para evitar comentarios duplicados.

Flujo de trabajo recomendado

Instala la App o añade la Action y abre un pull request listo para revisión. Empieza por el diagrama de arquitectura para localizar límites y componentes afectados. Después consulta el flujo de datos para seguir la ejecución y abre el lienzo si el cambio es amplio. Usa el mapa para decidir qué archivos y rutas requieren más atención, pero revisa igualmente el diff, el estado de CI y los casos límite. Las correcciones de nombres, agrupaciones o carriles se guardan en .github/pr-lens.yml para que sobrevivan a futuros pushes.

Precio, privacidad y límites

PR Lens es gratuito para proyectos de código abierto y el repositorio usa licencia MIT. Con Action o CLI pagas únicamente al proveedor del modelo elegido; la web oficial no publica un precio único verificable para repositorios privados en la App alojada. Esa App clona el commit del PR en un entorno desechable, analiza con Gemini, guarda documentos de grafo y SVG en almacenamiento de objetos y elimina el entorno al terminar. Los objetos guardados no tienen una caducidad automática definida por la aplicación y un enlace al render puede dar acceso a la imagen. Para código sensible, consulta la explicación oficial sobre datos y retención y valora la CLI local.

Preguntas frecuentes

¿PR Lens encuentra bugs o fallos de seguridad?

No. Visualiza qué cambia y cómo se relacionan las piezas; las herramientas de análisis y la revisión humana siguen siendo necesarias.

¿Necesita una clave de API?

La App alojada no requiere tu clave. Action y CLI usan la tuya; el skill reutiliza el modelo de tu agente de programación.

¿Funciona con repositorios privados?

La App puede instalarse en repositorios privados seleccionados, pero el equipo debe revisar el modelo de almacenamiento y acceso por enlace. También existen modos locales.

¿Qué ocurre después de otro push?

La App actualiza el comentario existente con los diagramas del nuevo estado, en lugar de añadir comentarios sucesivos.

Recursos oficiales

• Qué es PR Lens y qué modos ofrece
• Instalación y permisos de la GitHub App
• Código fuente MIT, configuración e incidencias