Norn is built around a diff-first workflow. From selecting a pull request to publishing comments, every step remains under the reviewer’s control.
1. Select the pull request
Browse open pull requests from Bitbucket Cloud and GitHub in the same workspace, without switching tools or losing review context.
For local work that has not reached a pull request yet, use headless working-tree or branch scope instead.
2. Explore the diff
Switch between unified and side-by-side views, preview image changes, and move quickly between modified files.
3. Collect evidence and suggestions
Run the local analyzers configured by the repository and, when useful, start a review with Claude or Codex. Results, findings, and evidence remain associated with the local review.
Optional analyzers run only when the selected workflow enables them. Headless
review requires --run-analyzers; organization policy may force explicitly
required analyzers.
4. Prepare drafts
Comments remain local drafts until you choose to publish them. You can review, edit, or discard them without changing the remote pull request.
5. Publish deliberately
Check the final summary and publish only the selected comments. Norn never publishes suggestions generated by AI assistants automatically.
6. Apply fixes when needed
When a review leads to a local change, you can sync the branch, apply the fix, create a commit, and push without losing the workspace context.