docs/reviewing-code.mdx
After a coding agent finishes work, you review its changes, leave inline comments, and send the agent back to address them. This review-feedback-fix loop repeats until you are satisfied.
There are three ways to open the changes panel:
Cmd/Ctrl + K, then search for "Show Changes Panel"The changes panel shows the diff viewer in the centre and the file tree on the right.
<Frame> </Frame>The file tree shows all files that were added, modified, or deleted. Click any file to load its diff in the viewer.
<Frame> </Frame>Use the search box at the top to filter files by name. The toggle button in the search bar lets you expand or collapse all folders at once.
<Tip> Start with the files you care most about — the main feature file or the entry point — rather than reviewing alphabetically. This gives you context for the rest of the changes. </Tip>The diff viewer uses colour coding to show what changed: green for additions, red for deletions, and grey for unchanged context lines.
You can switch between two view modes:
| Mode | Best for | How to switch |
|---|---|---|
| Unified | Quick scanning, small changes | Diff view toggle in the navbar |
| Side-by-Side | Large refactors, comparing old vs new | Same toggle, or Cmd/Ctrl + K → "Switch to Side-by-Side View" |
You can also switch views from the command bar (Cmd/Ctrl + K → "Switch to Side-by-Side View").
To leave feedback on a specific line, hover over it in the diff and click the comment icon that appears. Write your comment and submit it.
<Frame> </Frame>Good comments are specific and actionable. Here are some examples:
| Comment type | Example |
|---|---|
| Request a change | "This endpoint should validate the user ID before querying the database." |
| Ask a question | "Why did you choose a Map here instead of a plain object?" |
| Provide context | "This function is called from the auth middleware — it needs to handle expired tokens." |
After adding your comments, send them to the agent. You can include an optional message for extra context, or just send the comments on their own. A badge shows how many review comments will be included.
<Frame> </Frame>The agent sees all inline comments as context and works through them.