use-cases/github-code-reviews.md Codex Docs, 2026-05-02 06:45 UTC → 2026-05-14 07:00 UTC

1# Codex code review for GitHub pull requests | Codex use cases1---

2 2name: Codex code review for 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,

5![](/assets/OpenAI-black-wordmark.svg)5 missing tests, and documentation issues directly on a pull request.

6 6coverImage: /codex/use-cases/gh-pr-use-case.png

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)7skills:

8 8 - token: $security-best-practices

9Codex use case9 url: https://github.com/openai/skills/tree/main/skills/.curated/security-best-practices

10 10 description: Focus the review on risky surfaces such as secrets, auth, and

11# Codex code review for GitHub pull requests11 dependency changes.

12 12bestFor:

13Catch regressions and potential issues before human review.

14 

15Difficulty **Easy**

16 

17Time horizon **5s**

18 

19Use Codex code review in GitHub to automatically surface regressions, missing tests, and documentation issues directly on a pull request.

20 

21## Best for

22 

23 - Teams that want another review signal before human merge approval13 - Teams that want another review signal before human merge approval

24 - Large codebases for projects in production14 - Large codebases for projects in production

25 15starterPrompt:

26# Contents16 title: Ask Codex to review a pull request

27 17 body: "@codex review for security regressions, missing tests, and risky behavior

28[← All use cases](https://developers.openai.com/codex/use-cases)18 changes."

29 19 suggestedModel: cloud

30Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/github-code-reviews/?export=pdf)20relatedLinks:

31 21 - label: Codex code review in GitHub

32Use Codex code review in GitHub to automatically surface regressions, missing tests, and documentation issues directly on a pull request.22 url: /codex/integrations/github

33 23 - label: Custom instructions with AGENTS.md

34Easy24 url: /codex/guides/agents-md

35 25---

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 26 

63## How to use27## How to use

64 28 

85```49```

86 50 

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.51Codex 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[![](/images/codex/codex-wallpaper-2.webp)

92 

93### Deploy an app or website

94 

95Use Codex with Build Web Apps and Vercel to turn a repo, screenshot, design, or rough app...

96 

97Front-end Integrations](https://developers.openai.com/codex/use-cases/deploy-app-or-website)[![](/images/codex/codex-wallpaper-1.webp)

98 

99### Bring your app to ChatGPT

100 

101Build one narrow ChatGPT app outcome end to end: define the tools, scaffold the MCP server...

102 

103Integrations Code](https://developers.openai.com/codex/use-cases/chatgpt-apps)[![](/images/codex/codex-wallpaper-1.webp)

104 

105### Complete tasks from messages

106 

107Use Computer Use to read one Messages thread, complete the task, and draft a reply.

108 

109Knowledge Work Integrations](https://developers.openai.com/codex/use-cases/complete-tasks-from-messages)