app/review.md +34 −16
1# Review1# Review
2 2
3Review and iterate with Codex on changes inside the app
4
5The review pane helps you understand what Codex changed, give targeted feedback, and decide what to keep.3The review pane helps you understand what Codex changed, give targeted feedback, and decide what to keep.
6 4
7It only works for projects that live inside a Git repository. If your project5It only works for projects that live inside a Git repository. If your project
432. Hover the line you want to comment on.412. Hover the line you want to comment on.
443. Click the **+** button that appears.423. Click the **+** button that appears.
454. Write your feedback and submit it.434. Write your feedback and submit it.
46445. 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.
47 45
4846Because the comment is anchored to a line, Codex can usually respond moreBecause comments are line-specific, Codex can respond more precisely than with a
4947precisely than with a general instruction.general instruction.
50 48
5149Inline comments are treated as review guidance. After leaving comments, send aCodex treats inline comments as review guidance. After leaving comments, send a
52follow-up message that makes your intent explicit, for example “Address the50follow-up message that makes your intent explicit, for example “Address the
53inline comments and keep the scope minimal.”51inline comments and keep the scope minimal.”
54 52
57If you use `/review` to run a code review, comments will show up directly55If you use `/review` to run a code review, comments will show up directly
58inline in the review pane.56inline in the review pane.
59 57
6058 <CodexScreenshot
59 alt="Inline code review comments displayed in the review pane"
60 lightSrc="/images/codex/app/inline-code-review-light.webp"
61 darkSrc="/images/codex/app/inline-code-review-dark.webp"
62 maxHeight="400px"
63/>
64
65## Pull request reviews
66
67When Codex has GitHub access for your repository and the current project is on
68the pull request branch, the Codex app can help you work through pull request
69feedback without leaving the app. The sidebar shows pull request context and
70feedback from reviewers, and the review pane shows comments alongside the diff
71so you can ask Codex to address issues in the same thread.
72
73Install the GitHub CLI (`gh`) and authenticate it with `gh auth login` so Codex
74can load pull request context, review comments, and changed files. If `gh` is
75missing or unauthenticated, pull request details may not appear in the sidebar
76or review pane.
77
78Use this flow when you want to keep the full fix loop in one place:
61 79
6280 1. Open the review pane on the pull request branch.
812. Review the pull request context, comments, and changed files.
823. Ask Codex to fix the specific comments you want handled.
834. Inspect the resulting diff in the review pane.
845. Stage, commit, and push the changes to the PR branch when you are ready.
85
86For GitHub-triggered reviews, see [Use Codex in GitHub](https://developers.openai.com/codex/integrations/github).
63 87
64## Staging and reverting files88## Staging and reverting files
65 89
66The review pane includes Git actions so you can shape the diff before you90The review pane includes Git actions so you can shape the diff before you
67commit.91commit.
68 92
6993You can stage, unstage, or revert changes at multiple levels:You can stage, unstage, or revert changes at these levels:
70 94
71- **Entire diff**: use the action buttons in the review header (for example,95- **Entire diff**: use the action buttons in the review header (for example,
72 "Stage all" or "Revert all")96 "Stage all" or "Revert all")
76Use staging when you want to accept part of the work, and revert when you want100Use staging when you want to accept part of the work, and revert when you want
77to discard it.101to discard it.
78 102
79103### Partially staged states### Staged and unstaged states
80 104
81Git can represent both staged and unstaged changes in the same file. When that105Git can represent both staged and unstaged changes in the same file. When that
82happens, it can look like the pane is showing “the same file twice” across106happens, it can look like the pane is showing “the same file twice” across
83staged and unstaged views. That's normal Git behavior.107staged and unstaged views. That's normal Git behavior.
84
85[Previous
86
87Settings](https://developers.openai.com/codex/app/settings)[Next
88
89Automations](https://developers.openai.com/codex/app/automations)