PR Lens para visualizar e revisar pull requests

PR Lens é uma ferramenta de IA open source para visualizar pull requests. Ela transforma alterações de código em diagramas animados de arquitetura e fluxo de dados dentro do próprio PR, ajudando a equipe a entender o alcance da mudança antes de examinar cada linha.

Para que serve o PR Lens, em linguagem simples?

Um pull request grande obriga o reviewer a juntar mentalmente arquivos, serviços, chamadas e caminhos removidos. O PR Lens organiza isso em um mapa visual. A visão de arquitetura marca componentes adicionados, alterados e removidos e mantém os elementos inalterados que fornecem contexto. A visão de fluxo mostra a sequência de execução quando ela realmente existe. Portanto, a ferramenta explica a estrutura da mudança; ela não procura bugs ou vulnerabilidades automaticamente.

Como os diagramas ajudam no code review

Os componentes são agrupados em faixas que representam camadas ou limites do sistema, revelando o possível raio de impacto além da lista de arquivos. O fluxo animado ajuda a acompanhar endpoints, filas, workers e integrações na ordem. Um canvas completo oferece zoom, deslocamento, temas claro e escuro e um percurso guiado. Os SVGs não incluem JavaScript e são renderizados de forma determinística a partir de um documento tipado e validado.

GitHub App, Action, CLI ou skill

A GitHub App exige menos configuração: basta selecionar os repositórios, e ela mantém um comentário por PR, atualizado a cada push. A GitHub Action roda no seu CI com sua chave de modelo e aceita Gemini, OpenAI ou endpoints compatíveis. A CLI oferece análise, validação, renderização, composição do comentário e exportação local. O skill permite que o coding agent já aberto produza o documento do grafo. Escolha App ou Action por repositório para evitar comentários duplicados.

Fluxo de revisão recomendado

Instale a App ou adicione a Action e abra um pull request pronto para revisão. Comece pelo diagrama de arquitetura para localizar fronteiras, componentes novos e exclusões. Depois acompanhe o fluxo de dados e abra o canvas em mudanças amplas. Use o mapa para priorizar arquivos e caminhos, mas continue lendo o diff, verificando a CI e testando casos de borda. Correções persistentes de nome, exclusão ou agrupamento devem ficar em .github/pr-lens.yml, não no SVG gerado.

Preço, privacidade e limites

O PR Lens é gratuito para projetos open source e o repositório usa licença MIT. Na Action ou CLI, o custo é apenas o do provedor de modelo escolhido; o site oficial não apresenta um preço único verificável da App hospedada para repositórios privados. A App clona o head do PR em um sandbox descartável, analisa com Gemini, grava documentos de grafo e imagens em armazenamento de objetos e exclui o sandbox ao terminar. Os objetos armazenados não têm expiração automática definida pelo aplicativo, e quem possui o link do render pode acessar a imagem. Para código sensível, leia a explicação oficial sobre dados e retenção e considere a CLI ou o skill local.

Perguntas frequentes

O PR Lens encontra bugs ou falhas de segurança?

Não. Ele visualiza o que mudou; ferramentas de análise, segurança e revisão humana continuam necessárias.

Preciso de uma chave de API?

Não para a App hospedada. Action e CLI usam sua própria chave; o skill reutiliza o modelo do coding agent atual.

Funciona em repositórios privados?

A App pode acessar os repositórios privados selecionados, mas a equipe deve avaliar armazenamento e acesso por link. Os modos locais oferecem mais controle.

O que ocorre depois de outro push?

A App atualiza o comentário existente com os diagramas do novo estado do PR.

Recursos oficiais

• Visão geral e modos do PR Lens
• Instalação e permissões da GitHub App
• Código MIT, configuração e issues