ZeroTwo reviews GitHub pull requests when you ask it to, from the Code Review page in the desktop app. It does not install a GitHub app, answer @ mentions on a pull request, or review every new pull request automatically, and there is no separate Security Review product. A review is private: ZeroTwo reports to you and does not post to GitHub.
Before you start
You need the ZeroTwo desktop app and the GitHub CLI (gh) installed and signed in on that computer, because the page reads pull requests through it. If gh is missing or signed out, the page explains what to fix and offers a retry.
Open the Code Review page
Choose Code Review in the left rail. The sidebar groups pull requests under Authored by me, Needs my review, Needs my team's review, and Recently merged. Use the search box to search your pull requests or paste a pull request link, then open one to switch between Summary and Changes.
Request a ZeroTwo review
Select Review with ZeroTwo in the pull request header. ZeroTwo opens a chat beside the pull request, reads the description and the full diff, and reports the bugs and regressions a maintainer would act on, with file and line references and an assessment of overall risk. It does not change code or comment, approve, or post anything on GitHub for you.
Customize what ZeroTwo reviews
The gear beside Review with ZeroTwo opens Review instructions, headed "Tell ZeroTwo how to review your code". Write guidance there, use Add example for a starting point, then Save or Save and run to start a review at once. The same instructions apply to every review you start.
Begin with two or three rules that are:
- consequential and specific to your codebase, explaining the stakes;
- explicit about the safe path or the exception;
- scoped, durable, and outcome-based;
- free of lint or formatting checks that CI already covers.
Run it on a representative pull request, then prune noisy rules. Instructions guide ZeroTwo but don't replace tests or required approvals. To focus a single review, ask in the review chat, for example: check the database migration for issues.
Security review
For a security-focused pass, install the Security plugin from Customize > Plugins. It includes the security-diff-scan skill for reviewing a diff, plus threat modeling and fix skills. Mention it in a chat that has the pull request in context.
Act on review findings
The pull request page has Fix buttons for merge conflicts, failing checks (all of them, or one), and unresolved review comments. Each sends a request to the linked chat, where ZeroTwo works on the pull request branch, runs relevant tests, and pushes the change. Review what it pushed before you merge. The header also offers Mark ready on a draft and a Merge menu with merge commit, squash, and rebase.
Give ZeroTwo other tasks
Use the Ask about this pull request box at the bottom of the page to start a chat about it. In any chat, the GitHub connector under Customize > Connectors gives ZeroTwo access to your repositories, and the GitHub plugin adds skills such as gh-fix-ci and gh-address-comments.
Troubleshoot code review
If the page is empty or an action fails, verify:
- You are in the desktop app, since Code Review is not on the web.
ghis installed and signed in to an account that can see the repository.- The pull request appears under one of your sections, or paste its link in the search box.
- Your review instructions are saved and the right pull request is selected.