use-cases/github-code-reviews.md Codex Docs, 2026-04-23 18:31 UTC → 2026-05-14 07:00 UTC

1# Review pull requests faster | 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# Review pull requests faster11 dependency changes.

12 12bestFor:

13Catch regressions and potential issues before human review.

14 

15Difficulty **Easy**

16 

17Time horizon **5s**

18 

19Use Codex 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 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[Use Codex 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 

65Start by adding Codex code review to your GitHub organization or repository. See [Use Codex in GitHub](https://developers.openai.com/codex/integrations/github) for more details.29Start by adding Codex code review to your GitHub organization or repository.

30See [Codex code review in GitHub](https://developers.openai.com/codex/integrations/github) for more details.

66 31 

67You can set up Codex to automatically review every pull request, or you can request a review with `@codex review` in a pull request comment.32You can set up Codex to automatically review every pull request, or you can request a review with `@codex review` in a pull request comment.

68 33 

70 35 

71This will start a new cloud task that will fix the issue and update the pull request.36This will start a new cloud task that will fix the issue and update the pull request.

72 37 

73## Define additional guidance38## Define review guidance

74 39 

75To customize what Codex reviews, add or update a top-level `AGENTS.md` with a section like this:40To customize what Codex reviews, add or update a top-level `AGENTS.md` with a section like this:

76 41 

84```49```

85 50 

86Codex 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.

87 

88## Related use cases

89 

90[![](/images/codex/codex-wallpaper-2.webp)

91 

92### Deploy an app or website

93 

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

95 

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

97 

98### Bring your app to ChatGPT

99 

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

101 

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

103 

104### Complete tasks from messages

105 

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

107 

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