Skip to content

Repository files navigation

Code-Aware PR Review

Code-Aware PR Review

Open in Minds

Didn't work? Create a Minds workspace and paste this to your agent: /use-template https://github.com/gnguralnick/code-aware-pr-review

Why you care

GitHub's diff view shows you the lines that changed, but hides almost all of the code around them -- so reviewing a real change means constantly clicking away to see the rest of the file, hunting for where a function is defined, or guessing at what a symbol is. This app puts the whole file back on screen: it checks out the repository at the pull request's head commit and shows every changed file as a full-file diff, with real hover, go-to-definition, and find-usages across the tree. You review with the context actually in front of you, and you act on the PR -- comment, review, merge, and more -- without ever leaving the page.

How to use it

Once it is running you open a single tab in your workspace:

  1. Your PR list. A table of the pull requests you authored plus the ones you were asked to review, each annotated with its CI, review, and merge-conflict status. Click any row to open it.
  2. The code-aware review. Each changed file opens as a full-file diff in a Monaco editor -- the changed lines highlighted in the context of the entire file. Hover a symbol for its type and docs, jump to a definition, or find every usage of a symbol across the whole checked-out repo. Python and JavaScript/TypeScript work with zero setup; an opt-in "rich types" mode installs the repo's own dependencies to resolve third-party and inferred types too.
  3. Acting on the PR. Without leaving the app: post conversation comments, submit a line-comment review (approve / request changes / comment), edit the title and description, close/reopen or merge, resolve and reopen review threads, and flip a PR between draft and ready-for-review.
  4. Ask an agent. Hand a question about the change to a headless agent that investigates inside the checked-out code and streams back what it finds.

It connects to GitHub through Minds' latchkey gateway, so no token ever lives in the app; you approve the GitHub access once when you adopt it.

Ideas for making it yours

  • Make it a team review queue. Drive the PR list off explicit repo or org filters instead of just the single signed-in viewer, so you can watch a whole project's open reviews.
  • Add another language's rich types. The zero-setup path covers Python and JS/TS; wire the prepare step up for Go, Rust, or Java to get hover and go-to-definition there too.
  • Tune the "ask an agent" investigator. Change its prompt or the tools it is allowed, or point it at a different model, to match how your team wants questions answered.
  • Change where it lives. Move it off port 8082, or restyle the frontend (assets/app.css / app.js) to match your own look.
  • Bake in default repos. Pre-seed the source-tree cache or default the list to the repos you review most, so it is useful the moment it opens.

What this is

This repository is a published minds template: a clean, bootable snapshot of what a mind built, ready to adapt into your own. It is NOT the generic workspace template -- it is this specific project.

template.md is the full manifest -- what it is, how it works, what it needs to run, and what to adapt -- with the machine-readable half (recipe, requirements, and the environment it needs installed) in template.toml.

About

A cleaner, code-aware interface for reviewing your GitHub pull requests

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages