Your first review
Install Diffgazer, run the setup wizard, and read your first review.
The fastest path is three commands, run from inside a git repository that has uncommitted changes. Before a review can start you need a ready configuration for one selectable product.
Quick path
Before you press Review Unstaged or Review Staged, make sure:
- Node.js 22 or newer and
gitare installed. - The repository has changes to review.
- A configuration is ready: the product tuple is admitted, an exact model is selected, the provider consent (and with it the product's notice) is accepted, and any required live probe has not been left in skipped state.
- The current directory is trusted with read access.
Prerequisites
- A git repository with changes to review.
- Node.js 22 or newer, and a
gitbinary on your PATH. - A supported product configuration. The wizard lists all nine selectable products from the providers reference.
Steps
Install the CLI
Change into your repo
Start Diffgazer
It prints a banner, starts a local server at http://localhost:3000, and opens that address in your browser.
Complete the setup wizard
Pick a product, then work through that product's setup plan: Endpoint, Authentication, Model, and Consent. See What the first run looks like below.
Trust the repository
Trust the directory when prompted, leaving "read files" enabled so Diffgazer can read your code.
Start a review
From the main menu, choose Review Unstaged (or Review Staged). At this point, Diffgazer sends the diff and prompt content to the admitted product you configured under that product's policy.
Open your issues
Skim the summary, press Enter to open the full review, then move through the issue list to read each issue.
Tip: If port 3000 is already taken, set another one with PORT, for example PORT=4000 diffgazer.
What the first run looks like
On first launch Diffgazer has no saved configuration, so the browser opens into the setup wizard. The steps come from the selected product's setup plan: product selection, endpoint binding, authentication, exact model selection, and the provider consent.
Hosted API setup
- Pick the product from the nine selectable entries.
- Bind the allowed endpoint.
- Choose how the credential is supplied: Enter credential now for a write-only literal, or Use environment reference to bind the product's environment variable. The variable name is fixed per product — there is nothing to type.
- Select an exact discovered model ID.
- Accept the provider consent — Diffgazer sends repository content to the provider you configure, using your own credentials, and stores nothing remotely; billing, rate limits, retention and training terms are that provider's. The product's own billing and privacy notice reads alongside it. This is asked once; later configurations acknowledge their product's notice for you unless that notice materially changed. If you skipped the wizard, the same Provider data notice opens the first time you configure a provider (before the credentials dialog), select or verify a configuration, or start a review — Accept and continue runs the action, Not now cancels only that action.
Saving runs no billed probe — your first review verifies structured review support for the exact tuple and model. The optional Verify action on the Providers page (under More, or the v key) checks it sooner and shows the last result.
Example environment-reference flow without embedding a secret:
In the wizard, choose Use environment reference. Diffgazer records the reference, resolves GOOGLE_API_KEY on the server side, and never stores the value. See Environment variables for each product's name.
Trust the directory
Before the first review, Diffgazer asks you to trust the current repository. Choose Trust & Continue to save the grant for this directory. If you skip it, review actions stay blocked.
Run a review
The main menu offers Review Unstaged and Review Staged. Pick one and Diffgazer collects the diff, gathers context, and streams the run live. See reviewing for the run screen in detail.
Read the issues
When the run finishes you land on a summary with severity breakdown and top issues. Press Enter to open the full review and read Details, Explain, Trace, and Patch tabs for each issue.
Where to go next
Tip: Stop Diffgazer with Ctrl+C in the terminal where it is running.