← all repositories
coldteadotai/pr-lens

It diagrams your pull request so you don't have to

PR Lens posts animated architecture and data-flow diagrams into your pull request comments so reviewers can see the blast radius before reading a line of code.

1k stars TypeScript Coding AssistantsLLMOps · Eval
pr-lens
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does

PR Lens analyzes a pull request and renders it as SVG diagrams embedded directly in the PR comment. It maps the change as an architecture diagram—showing touched components against the wider system, color-coding green for new, amber for changed, and red for deleted—and as an animated sequence diagram that walks through data flow one step at a time. The comment nests scoped views inside collapsible sections, and every diagram links to an interactive canvas for panning, zooming, and light or dark themes.

The interesting bit

Rather than calling out to a black-box service, the tool splits the work into a graph document that describes the change and a validator that enforces the schema before rendering. That design lets coding agents generate their own diagrams without spending an extra provider key: the agent already understands the diff, writes the document, and iterates against the validator until the contract is satisfied. It is a neat separation between “know what changed” and “draw it consistently.”

Key highlights

  • Blast-radius architecture: Components involved in the PR and the calls between them, with color-coded deltas.
  • Animated data-flow walkthroughs: A dot traces each step in order; playable in the comment or on the interactive canvas.
  • Nested drill-down: The comment uses <details> blocks to separate the full blast radius, the new path, and retired code.
  • Agent-native: Runs as a GitHub App, Action, or CLI, and offers a skill mode where agents write and validate the graph document locally.
  • Theme-aware: Diagrams ship as paired SVGs that automatically match the reader’s GitHub light or dark preference.

Caveats

  • The README notes the underlying model can rename things between runs, and the project supplies a YAML overlay for pinning component names, exclusions, and lane groupings.
  • Agent mode requires manually satisfying a schema contract and iterating validation, which is more hands-on than the turnkey GitHub App.

Verdict

Teams juggling large diffs or monorepo refactors will get the most value from seeing blast radius before diving into files. Solo developers on small, stable codebases likely do not need an automated diagrammer in their review loop.

Frequently asked

What is coldteadotai/pr-lens?
PR Lens posts animated architecture and data-flow diagrams into your pull request comments so reviewers can see the blast radius before reading a line of code.
Is pr-lens open source?
Yes — coldteadotai/pr-lens is open source, released under the MIT license.
What language is pr-lens written in?
coldteadotai/pr-lens is primarily written in TypeScript.
How popular is pr-lens?
coldteadotai/pr-lens has 1k stars on GitHub.
Where can I find pr-lens?
coldteadotai/pr-lens is on GitHub at https://github.com/coldteadotai/pr-lens.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.