1# Review GitHub pull requests | Codex use cases1---
2 2name: Review GitHub pull requests
3Codex use cases3tagline: Catch regressions and potential issues before human review.
4 4summary: Use Codex code review in GitHub to automatically surface regressions,
55 missing tests, and documentation issues directly on a pull request.
6 6skills:
77 - token: $security-best-practices
8 8 url: https://github.com/openai/skills/tree/main/skills/.curated/security-best-practices
9Codex use case9 description: Focus the review on risky surfaces such as secrets, auth, and
10 10 dependency changes.
11# Review GitHub pull requests11bestFor:
12 12 - Teams that want another review signal before human merge approval
13Catch regressions and potential issues before human review.13 - Large codebases for projects in production
14 14starterPrompt:
15Difficulty **Easy**15 title: Ask Codex to review a pull request
16 16 body: "@codex review for security regressions, missing tests, and risky behavior
17Time horizon **5s**17 changes."
18 18 suggestedModel: cloud
19Use Codex code review in GitHub to automatically surface regressions, missing tests, and documentation issues directly on a pull request.19relatedLinks:
20 20 - label: Codex code review in GitHub
21## Best for21 url: /codex/integrations/github
22 22 - label: Custom instructions with AGENTS.md
23- Teams that want another review signal before human merge approval23 url: /codex/guides/agents-md
24- Large codebases for projects in production24---
25
26# Contents
27
28[← All use cases](https://developers.openai.com/codex/use-cases)
29
30Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/github-code-reviews/?export=pdf)
31
32Use Codex code review in GitHub to automatically surface regressions, missing tests, and documentation issues directly on a pull request.
33
34Easy
35
365s
37
38Related links
39
40[Codex code review in GitHub](https://developers.openai.com/codex/integrations/github) [Custom instructions with AGENTS.md](https://developers.openai.com/codex/guides/agents-md)
41
42## Best for
43
44- Teams that want another review signal before human merge approval
45- Large codebases for projects in production
46
47## Skills & Plugins
48
49- [Security Best Practices](https://github.com/openai/skills/tree/main/skills/.curated/security-best-practices)
50
51 Focus the review on risky surfaces such as secrets, auth, and dependency changes.
52
53| Skill | Why use it |
54| --- | --- |
55| [Security Best Practices](https://github.com/openai/skills/tree/main/skills/.curated/security-best-practices) | Focus the review on risky surfaces such as secrets, auth, and dependency changes. |
56
57## Starter prompt
58
59@codex review for security regressions, missing tests, and risky behavior changes.
60
61@codex review for security regressions, missing tests, and risky behavior changes.
62 25
63## How to use26## How to use
64 27
75 38
76To customize what Codex reviews, add or update a top-level `AGENTS.md` with a section like this:39To customize what Codex reviews, add or update a top-level `AGENTS.md` with a section like this:
77 40
78```41```md
79## Review guidelines42## Review guidelines
80 43
81- Flag typos and grammar issues as P0 issues.44- Flag typos and grammar issues as P0 issues.
85```48```
86 49
87Codex applies guidance from the closest `AGENTS.md` to each changed file. You can place more specific instructions deeper in the tree when particular packages need extra scrutiny.50Codex applies guidance from the closest `AGENTS.md` to each changed file. You can place more specific instructions deeper in the tree when particular packages need extra scrutiny.
88
89## Related use cases
90
91[
92
93### Bring your app to ChatGPT
94
95Build one narrow ChatGPT app outcome end to end: define the tools, scaffold the MCP server...
96
97Integrations Code](https://developers.openai.com/codex/use-cases/chatgpt-apps)[
98
99### Coordinate new-hire onboarding
100
101Use Codex to gather approved new-hire context, stage tracker updates, draft team-by-team...
102
103Integrations Data](https://developers.openai.com/codex/use-cases/new-hire-onboarding)[
104
105### Draft PRDs from internal context
106
107Use Codex with the $documents skill and connected apps such as Linear, Slack, Notion or...
108
109Integrations Knowledge Work](https://developers.openai.com/codex/use-cases/draft-prds-from-sources)
110