| name | pr-map |
| description | Turn a GitHub pull request into an interactive review map with AI insights, reviewed in the browser. Use when the user asks to review, map, or visualize a PR. |
pr-map
Turn a GitHub pull request into an interactive map of the changed files plus AI review insights,
opened in a local browser dashboard where the human reads diffs and submits a review.
Prerequisites (check first; stop with a clear message if unmet)
gh auth status succeeds.
- The current directory is a checkout of the PR's repository.
$PRMAP_HOME points to the pr-map repository clone.
Steps
-
Resolve the PR reference from the user's argument (number or URL); default to the current
branch's PR if none is given.
-
Run the standalone pipeline. It builds the static graph, enriches each changed file with the
configured LLM provider (local Ollama by default), merges the result, and opens the dashboard:
node "$PRMAP_HOME/pr-map-plugin/dist/pr-map.js" <url-or-number>
-
The dashboard opens in the browser. The human explores the graph, reads each file's diff and
insights, writes comments, and submits a verdict (Approve / Request changes / Comment).
The rule
The AI enrichment is a set of review suggestions to guide the human, not verified facts. Never
submit a review on the user's behalf — submitting is an explicit action the human takes in the
dashboard.
Provider configuration
Enrichment uses whatever the PRMAP_LLM_* environment variables select. See the repository's
integrations/README.md for the variable table.