Skip to content

Diff view

Before you ship, the diff view shows every change the agent made — with a plain-English rationale for each file and any review findings alongside.

Layout

  • Main panel — the diff of all changed files, grouped by file, with additions and deletions highlighted.
  • Per-file rationale — a short explanation of why each file changed, so you don't have to reverse-engineer the agent's intent.
  • Findings sidebar — the review findings, grouped by severity and linked to the code they point at. Click one to read it in full in the findings viewer.
  • Summary — an AI-generated overview of the whole change at the top.

Why the rationale matters

Reviewing AI-written code is faster when you know the intent. The per-file rationale tells you what the agent was trying to do, so you can check whether the code actually does it — rather than reading every line cold.

From diff to ship

The diff is the Review step of the task flow. Once you're happy:

  • Fix anything outstanding with Fix with AI (re-runs the agent), or
  • Save to branch to merge the approved work and move on to shipping.

TIP

Open the diff from the task drawer (the Review step), from a session (the Diff tab), or from the Needs you card in the Queue.