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
- Click "+ New Review" (or "Start First Review" when the list is empty). Enter a "Title" and optionally a "PR URL".
- Describe the change in "PR Description", then paste your git diff into "Diff Content". The diff is required.
- Optionally set "Primary Language" and search for a "Linked Story" by title or ticket code, then click it in the results.
- Click "Review with AI ▶". The review is created and run straight away, and the finished review opens in the list.
- 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.
- 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