Review Assist
About
Turns an AI coding agent's session into a reviewable Intent Document: the problem, the assumptions, the rejected alternatives, and an anchored walkthrough of the diff.
Details
- Author
- uditk2
- Categories
- Developer Tools
Jump to
Setup
Install Review Assist in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/uditk2/review-assist
Follow the installation instructions in the repository README, then restart your MCP client.
Review AI-written code as fast as agents write it.
Turn a coding agent's session into a guided, verifiable pull-request review.
Install·Update·Uninstall·How it works·Architecture·Developing·Contributing
AI agents write code faster than anyone can read diffs — and the context that makes review fast (what was asked, what was assumed, what was tried and abandoned, what was tested) is thrown away the moment the PR opens. Review Assist captures it at the source: an agent's session becomes anIntent Document, a validator proves it actually covers the diff, and a GitHub App renders it as a guided review on top of the pull request.
Fully open source, self-hostable, andstores none of your code. Your session transcript never leaves your machine. The app has no database: it reads the document and diff from GitHub per request with the reviewer's own token, keeps them in memory for the length of that request, and serves themprivate, no-storeto a viewer that renders in the reviewer's browser. Nothing is written down, but your code does pass through the service in transit — if that matters to you, self-host it.
Two one-time installs — the MCP server on the developer's side, the GitHub App on the repo's.
1. Register the MCP server with your agent(so it can author Intent Documents). Claude Code and Codex keep separate configs, so registering with one does not register with the other — run the section(s) you use.
claude mcp add -s user review-assist -- npx -y review-assist-mcp
The CLI and the VS Code extension share this one-s userconfig — but only when the extension inherits your shell'sPATH(launched viacode ., not the Dock). Launched from the Dock, GUI apps on macOS get just/usr/bin:/bin:/usr/sbin:/sbin, sonpxisn't found and the server showsnot connectedwith no error. Register withoutnpxinstead:
npm install -g review-assist-mcp claude mcp add -s user review-assist -- "$(which node)" "$(npm root -g)/review-assist-mcp/dist/index.js"
codex mcp add review-assist -- npx -y review-assist-mcp
Shared with the IDE extension (~/.codex/config.toml) under the samecode .caveat as above. Dock-launched VS Code:
npm install -g review-assist-mcp codex mcp add review-assist -- "$(which node)" "$(npm root -g)/review-assist-mcp/dist/index.js"
(Skipnpm install -gif you already ran it for Claude Code — one global install serves both extensions; each still needs its ownmcp add.)
Claude desktop app — one-click, no terminal:download the.mcpband open it.
One click. Read-only code + PR comments, no workflow files — it adds the automatic check on every PR, the summary comment, and the guided-review viewer.
Only relevant if you used the global-install form above (npm install -g) —npx -yresolves to the latest release on every launch by itself.
Restart your agent afterward so it respawns the server process.
claude mcp remove -s user review-assist # or: codex mcp remove review-assist npm uninstall -g review-assist-mcp # only if you used the global-install form rm -rf ~/.review-assist # consent decisions and local run state
Three systems and two external actors. Your machine produces the change and its Intent Document; the session transcript never leaves it. GitHub holds the pull request and every durable piece of review state. The application reacts topull_requestevents and posts the check as its bot identity, then serves the guided review, reading and writing GitHub as the signed-in reviewer.
The two-agent distillation — author and reviewer as separate role-locked contexts, and the tools each one may reach — is a component-level view, kept indocs/ARCHITECTURE.mdalong with the full route list.
npm install npm run build # Validate and render the example Intent Document node packages/validator/dist/cli.js validate packages/schema/src/example.json node packages/validator/dist/cli.js render packages/schema/src/example.json # Preview the guided viewer with mock data → http://localhost:8787/#acme/checkout-service/pull/42 node scripts/mockserver.mjs # Tests npx vitest run
Architecture and internals:docs/ARCHITECTURE.md.
Issues and pull requests are welcome. If the guided review reads wrong on one of your pull requests,open an issuewith the Intent Document and the diff that produced it — that pair is usually enough to reproduce. Proposals to change the format itself are worth raising as an issue first, sinceSPEC.mdis deliberately frozen and any change ripples through the validator, the viewer, and every document already committed.
Before opening a pull request, run the checks underDeveloping; CI runs the same build, typecheck, tests, and example validation.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Create crafted UI components inspired by the best 21st.dev design engineers.
Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
ALAPI MCP Tools,Call hundreds of API interfaces via MCP
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.
APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





