Writing review comments
Draft comments on the diff, adopt the AI's suggestions as your own, polish or dictate them, and submit the review under your own token.
Reading a change is half the job. DiffGuardian is also where you write the review — draft comments on the diff, adopt the AI's suggestions as your own, and submit the whole thing to your code host in one go.
Commenting itself is available on every plan. Two of the writing aids — Polish and Dictate — are Pro.
#Drafting a comment
Click a line in the diff to open the composer, write your comment, and add it. Comments stay as drafts on your machine until you decide to submit them, so you can write a review across several sittings and change your mind about any of it. Existing threads can be replied to in place.
An individual comment can also be posted immediately with Post now, when you want to ask the author one question rather than hold it for the full review.
#Adopting AI suggestions
An AI review produces suggested comments rather than posting anything. Each one can be adopted into a draft comment — or all of them at once with Adopt All — and every adopted suggestion is an ordinary draft afterwards: edit it, rewrite it, or delete it before it goes anywhere. A Trace It walkthrough step can be adopted the same way.
Nothing an AI wrote reaches your code host until you put your name on it.
#Polish
Pro. Polish rewrites the draft in your composer into clear, professional prose, grounded in the diff hunk the comment is attached to — so it stays accurate about the code rather than merely reading better. It is a one-shot transform: the text in the box is replaced with the result, and you can keep editing.
Polish is routed to the Input Assistant model in Settings → Model routing. A small, cheap model is usually plenty. See Choosing an AI backend.
#Dictate
Pro, and part of Voice. Click Dictate, say what you mean, and stop. The raw transcript — filler words, false starts and all — is written up into a clean comment, again grounded in the hunk it is attached to. If the composer already holds a draft, what you said is merged into it rather than replacing it.
Dictation needs microphone access. On macOS, grant it under System Settings → Privacy & Security → Microphone.
#Submitting the review
Finalize review collects your drafts and submits them to your code host as a single review, using your own access token, posting as you. You choose:
- The verdict — Approve, Comment (no verdict), or Request changes.
- An optional summary note for the author, which the AI can draft for you.
Nothing is submitted until you press the button, and DiffGuardian never posts, approves or merges on its own. For a local repository with no remote, the review is saved locally instead — there is nowhere to submit it to.