{"slug": "show-hn-guidedreview-review-ai-generated-code-before-you-sign-your-name-to-it", "title": "Show HN: GuidedReview – Review AI-generated code before you sign your name to it", "summary": "GuidedReview, a free open-source tool from developer Nshntarora, turns GitHub pull requests and local git changes into an ordered walkthrough of review units, clustering related code hunks with AI commentary so developers can read diffs with intent. The tool, available as a Chrome extension and CLI via `npx @guided-review/cli`, requires users to bring their own LLM API key and has no product backend, with the code always sourced from the real diff for the developer to read and decide. GuidedReview addresses the difficulty of reviewing large AI-generated code changes by providing structure while emphasizing that automated review agents lack taste and cannot replace human judgment.", "body_md": "Guided Review turns GitHub pull requests and local git changes into an ordered walkthrough of **review units** so you can read the change with intent instead of reconstructing it from an alphabetical file list.\n\n1. Run `npx @guided-review/cli` in your project directory (or click on Start Guided Review on a GitHub PR if you're using the Chrome Extension)\n2. When you ask for AI structure, your LLM clusters related hunks and adds short commentary — schema, then logic, then call-sites, then tests.\n3. Follow the walkthrough keyboard-first. The code always comes from the real diff; **you still read it and decide** .\n\nFree, open source, bring your own LLM key. Guided Review has no product backend: the extension and CLI talk directly to your AI provider, and the extension talks to GitHub for PRs.\n\n- **Chrome extension** —[Chrome Web Store](https://chromewebstore.google.com/detail/pdnnimoajmnjpccboemeomoeomancodd) , or build from source below\n- **CLI** —`npx @guided-review/cli` ([npm](https://www.npmjs.com/package/@guided-review/cli) )\n\nSite and docs: [guidedreview.dev](https://guidedreview.dev) · [docs](https://guidedreview.dev/docs).\n\nAutomated review agents help find bugs and edge cases you missed — useful — but they are not a replacement for you. They lack taste: product context, people, when an abstraction is unnecessary, when to break the rules.\n\nEven with AI today, nothing beats reading the code. GitHub still hands you every changed file in alphabetical order; a raw `git diff` is no better. That was awkward for human-written diffs; for large AI-shaped changes it is actively hostile.\n\nGuided Review uses AI only where it helps: clustering related hunks into a walkable order and adding short summaries you can take or ignore.\n\nThe Chrome extension does this on GitHub PRs. This CLI does the same for local work — before you open the PR, or when there is no PR at all.\n\n**From the store:** install from the [Chrome Web Store](https://chromewebstore.google.com/detail/pdnnimoajmnjpccboemeomoeomancodd), open Options → add an LLM API key → open a GitHub PR → **Start Guided Review**.\n\n**From source** — requires **Node.js** ≥ 22, **pnpm** ≥ 11, and **Chrome**:\n\n1. Install dependencies from the monorepo root:\n\n```\npnpm install\n```\n\n1. Build the extension:\n\n```\npnpm build:extension\n```\n\n1. \nLoad it in Chrome: \n - Open `chrome://extensions`\n - Enable **Developer mode**\n - **Load unpacked** → select**`apps/extension/dist`** (never a root-level` dist/` )\n2. Open \n3. \nOpen Options → add an LLM API key → open a GitHub PR → **Start Guided Review**\n\nRequires **Node.js** ≥ 22. No clone needed:\n\n```\nnpx @guided-review/cli\n```\n\nThe CLI starts a local server on `127.0.0.1`, opens a browser UI, and walks the current branch versus its base, uncommitted work, or a single commit. It starts file-by-file and does not call an LLM until you click **Structure With AI**.\n\n```\nnpx @guided-review/cli --base main --no-open\nnpx @guided-review/cli --staged --agent claude-code\n```\n\nThe binary is `guidedreview`. Full detail: [CLI](https://guidedreview.dev/docs/cli) · [` apps/cli/README.md`](/nshntarora/guidedreview/blob/main/apps/cli/README.md).\n\nFrom this repo after `pnpm install`:\n\n```\npnpm build:cli\npnpm review\npnpm review -- --base main --no-open\n```\n\nFor day-to-day work with HMR:\n\n```\npnpm dev # extension Vite / crx on port 5173\npnpm dev:cli # CLI UI + server\npnpm dev:web # marketing site → http://localhost:3000\n```\n\nAfter extension code changes, rebuild if needed (`pnpm build:extension`), **Reload** the extension card in `chrome://extensions`, and refresh the PR tab. Chrome serves whatever is currently in `dist/` — a running dev server alone does not replace that reload.\n\nMore detail: [apps/extension/README.md](/nshntarora/guidedreview/blob/main/apps/extension/README.md) · [apps/cli/README.md](/nshntarora/guidedreview/blob/main/apps/cli/README.md) · [apps/web/README.md](/nshntarora/guidedreview/blob/main/apps/web/README.md).\n\n```\npnpm build:extension # typecheck + Vite → apps/extension/dist (+ zip)\npnpm build:cli # CLI binary + UI → apps/cli/dist\npnpm build # every workspace package with a build script (extension, site, CLI)\npnpm build:web # Next.js static export → apps/web/out\n```\n\nFrom the monorepo root:\n\n```\npnpm test # unit tests (extension + UI)\npnpm test:e2e:install # Chromium for extension e2e (once)\npnpm test:e2e # extension Playwright e2e (builds first)\npnpm test:e2e:web # marketing site e2e (builds first)\npnpm test:e2e:cli # CLI Playwright e2e (builds first)\n```\n\nAlso available: `pnpm typecheck`, `pnpm lint`, `pnpm format`. Workspace-scoped runs use `pnpm --filter @guided-review/