Docs / Engineering

Code Review

An AI review of a code change that you paste in as a diff. It lists issues and suggestions and gives a verdict.

When to use it

Before a pull request is merged, as a second pair of eyes.

Start here

Click "+ New Review" (or "Start First Review"), paste the diff and click "Review with AI".

How to use it

  1. Click "+ New Review" (or "Start First Review" when the list is empty). Enter a "Title" and optionally a "PR URL".
  2. Describe the change in "PR Description", then paste your git diff into "Diff Content". The diff is required.
  3. Optionally set "Primary Language" and search for a "Linked Story" by title or ticket code, then click it in the results.
  4. Click "Review with AI ▶". The review is created and run straight away, and the finished review opens in the list.
  5. Read the result: the verdict badge, a summary, "Security Flags", "Issues" with file and line where known and a suggested fix, "Positive Aspects" and "Test Coverage" notes.
  6. Click any row in the list later to open or collapse an earlier review. Each row shows its verdict, the date, the number of issues and a count of critical or high security flags.

Good to know

  • The verdict is one of Approve, Request Changes or Comment.
  • Severity badges on flags and issues are critical, high, medium or low.
  • The round "Dev Agents" button at the bottom right also offers a "Code Reviewer" agent that takes a PR description and diff and shows its result in the side panel.

Related

Last updated 4 October 2026