app/review.md +29 −6
412. Hover the line you want to comment on.412. Hover the line you want to comment on.
423. Click the **+** button that appears.423. Click the **+** button that appears.
434. Write your feedback and submit it.434. Write your feedback and submit it.
44445. Once you are done with all your feedback, send a message back to the thread.5. After you finish leaving feedback, send a message back to the thread.
45 45
4646Because the comment is anchored to a line, Codex can usually respond moreBecause comments are line-specific, Codex can respond more precisely than with a
4747precisely than with a general instruction.general instruction.
48 48
4949Inline comments are treated as review guidance. After leaving comments, send aCodex treats inline comments as review guidance. After leaving comments, send a
50follow-up message that makes your intent explicit, for example “Address the50follow-up message that makes your intent explicit, for example “Address the
51inline comments and keep the scope minimal.”51inline comments and keep the scope minimal.”
52 52
57 57
5858
59 59
60## Pull request reviews
61
62When Codex has GitHub access for your repository and the current project is on
63the pull request branch, the Codex app can help you work through pull request
64feedback without leaving the app. The sidebar shows pull request context and
65feedback from reviewers, and the review pane shows comments alongside the diff
66so you can ask Codex to address issues in the same thread.
67
68Install the GitHub CLI (`gh`) and authenticate it with `gh auth login` so Codex
69can load pull request context, review comments, and changed files. If `gh` is
70missing or unauthenticated, pull request details may not appear in the sidebar
71or review pane.
72
73Use this flow when you want to keep the full fix loop in one place:
74
751. Open the review pane on the pull request branch.
762. Review the pull request context, comments, and changed files.
773. Ask Codex to fix the specific comments you want handled.
784. Inspect the resulting diff in the review pane.
795. Stage, commit, and push the changes to the PR branch when you are ready.
80
81For GitHub-triggered reviews, see [Use Codex in GitHub](https://developers.openai.com/codex/integrations/github).
82
60## Staging and reverting files83## Staging and reverting files
61 84
62The review pane includes Git actions so you can shape the diff before you85The review pane includes Git actions so you can shape the diff before you
63commit.86commit.
64 87
6588You can stage, unstage, or revert changes at multiple levels:You can stage, unstage, or revert changes at these levels:
66 89
67- **Entire diff**: use the action buttons in the review header (for example,90- **Entire diff**: use the action buttons in the review header (for example,
68 "Stage all" or "Revert all")91 "Stage all" or "Revert all")
72Use staging when you want to accept part of the work, and revert when you want95Use staging when you want to accept part of the work, and revert when you want
73to discard it.96to discard it.
74 97
7598### Partially staged states### Staged and unstaged states
76 99
77Git can represent both staged and unstaged changes in the same file. When that100Git can represent both staged and unstaged changes in the same file. When that
78happens, it can look like the pane is showing “the same file twice” across101happens, it can look like the pane is showing “the same file twice” across