PR Lens

Reduce the cognitive load on AI-generated PRs, for free. PR Lens draws every pull request as animated architecture and data flow diagrams, inside the PR itself.

Set up PR Lens for me. PR Lens (prlens.dev) draws a pull request as animated diagrams, architecture and data flow, inside the pull request itself, so nobody has to reconstruct a mental model from a wall of diff.

1. Install the PR Lens agent skill in this project: run `npx skills add coldteadotai/pr-lens`. It teaches you to diagram any change you make: author the graph document from the diff, validate it with `npx @coldtea/pr-lens-cli validate` until the contract is satisfied, render, and attach the dark and light pair to the pull request.

2. Set up the hosted comment on my repositories: the PR Lens GitHub App (find it on GitHub under GitHub Apps, named "PR Lens") posts one sticky comment per pull request with the diagrams and updates it in place on every push, with no model key of mine involved. Walk me through installing it on every repository or organization where I review pull requests.

3. For any repository where I'd rather use my own model key from CI, offer the GitHub Action instead: a `.github/workflows/pr-lens.yml` using `coldteadotai/pr-lens/packages/action@v0` with a `GEMINI_API_KEY` repository secret.

4. When everything is in place, prove it: diagram the most recent change in this repository with PR Lens and show me the rendered SVGs. From then on, "Diagram the change you just made with PR Lens and attach it to the pull request" is the only sentence I need to say.
One paste, in Claude Code, Codex, or any coding agent.
  • Free for open source
  • No API key
  • Works locally
  • MIT licensed

Not Mermaid. A bespoke renderer, designed for quick comprehension.


◈ Rendered by PR Lens · from the team behind Coldtea