Primary navigation

Code review

Learn how pull requests work, dig into findings, and check your local changes

ZeroTwo helps you understand changes, probe for problems and prepare review feedback in two places: the Code Review page for GitHub pull requests, and the review pane for changes in a local Git checkout. Both are in the desktop app. They are not available on the web or on mobile.

Pull request reviews

Code Review sits in the overflow menu of the icon rail. It reads GitHub through the GitHub CLI on your machine, so it needs gh installed and signed in with gh auth login; the page tells you which of the two is missing. It does not review pull requests automatically. A review runs when you ask for one.

View a pull request

  1. Open Code Review

    Pick Code Review from the rail's overflow menu.

  2. Select a pull request

    Choose one from the sidebar, or paste a pull request link into Search or paste a PR link.

  3. Read

    Summary shows the description, activity and checks. Changes shows the diff.

Find reviews that need attention

The sidebar groups pull requests under Authored by me, Needs my review, Needs my team's review and Recently merged. Pin one to keep it under Pinned. The Code Review options menu switches between Compact and Detailed rows and turns sections on or off.

Inspect changed files

On the Changes tab, each file is a card with a Mark as viewed toggle, and a file tree on the side has a Filter files… box. The toolbar offers word wrap, word-level diffs and hiding import changes. The right rail on Summary lists merge status, Threads (your linked ZeroTwo chats), comments, reviews and checks.

Ask questions about the change

Use Ask about this pull request at the bottom of the page, or open the linked chat tab or split view. Give the expected behavior and ask for evidence, such as the code path and tests behind an edge case, then check it yourself.

Review with ZeroTwo starts a private review in a new chat. A fresh reviewer subagent reads the description and diff and reports bugs and risks with file and line references. It does not change code, and it does not comment on or approve anything on GitHub.

Customize your review

The gear beside Review with ZeroTwo opens Review instructions. Write the criteria and report style you want, and they apply to every review you start from the page. Save and run saves them and begins a review at once.

Share feedback and follow up

Anything written to GitHub, including comments, replies, resolving threads, requesting reviewers, marking a pull request ready and merging, shows a confirmation dialog first. Ask ZeroTwo to draft a comment, check its file and line references, then post it yourself. On a failing check or an unresolved comment, a Fix pill asks ZeroTwo, in the linked chat, to fix it on the pull request branch and run the relevant tests.

Review local changes

In a Code chat on the desktop app, the /code-review command opens the review pane for the project's Git repository; Ctrl+Shift+G opens it too. Settings under Settings > Coding > Git include Review delivery, which chooses between Inline (in the current task) and Detached (a separate review task).

What changes it shows

The scope menu picks what the pane shows: All uncommitted, Unstaged (the default), Staged, Commit (choose from recent commits), Branch or Last turn. Without a local Git repository, such as on the web, it shows only Last turn.

Review multiple repositories

When a project has several repositories, the repository menu switches between them or shows All repositories.

Commit and push

The Commit or push button offers Commit, Commit and push and Push, with an Include unstaged changes option. ZeroTwo carries them out as an agent request, so Git settings and project instructions apply. The Review options menu has Refresh, Collapse all diffs, Hide white space and Copy git apply command, and a toggle switches to a split diff.