use-cases/github-code-reviews.md Codex Docs, 2026-04-15 06:44 UTC → 2026-05-07 17:08 UTC

1# Review pull requests faster | Codex use cases1---

2 2name: Codex code review for GitHub pull requests

3[← All use cases](https://developers.openai.com/codex/use-cases)3tagline: Catch regressions and potential issues before human review.

4 4summary: Use Codex code review in GitHub to automatically surface regressions,

5Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/github-code-reviews/?export=pdf)5 missing tests, and documentation issues directly on a pull request.

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

7Use Codex in GitHub to automatically surface regressions, missing tests, and documentation issues directly on a pull request.7skills:

8 8 - token: $security-best-practices

9Easy9 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

115s11 dependency changes.

12 12bestFor:

13Related links

14 

15[Use Codex in GitHub](https://developers.openai.com/codex/integrations/github) [Custom instructions with AGENTS.md](https://developers.openai.com/codex/guides/agents-md)

16 

17## Best for

18 

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

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

21 15starterPrompt:

22## Skills & Plugins16 title: Ask Codex to review a pull request

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

24- [Security Best Practices](https://github.com/openai/skills/tree/main/skills/.curated/security-best-practices)18 changes."

25 19 suggestedModel: cloud

26 Focus the review on risky surfaces such as secrets, auth, and dependency changes.20relatedLinks:

27 21 - label: Codex code review in GitHub

28| Skill | Why use it |22 url: /codex/integrations/github

29| --- | --- |23 - label: Custom instructions with AGENTS.md

30| [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. |24 url: /codex/guides/agents-md

31 25---

32## Starter prompt

33 

34@codex review for security regressions, missing tests, and risky behavior changes.

35 

36@codex review for security regressions, missing tests, and risky behavior changes.

37 26 

38## How to use27## How to use

39 28 

40Start 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.

41 31 

42You 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.

43 33 

45 35 

46This 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.

47 37 

48## Define additional guidance38## Define review guidance

49 39 

50To 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:

51 41 

59```49```

60 50 

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

62 

63## Related use cases

64 

65[![](/images/codex/codex-wallpaper-1.webp)

66 

67### Bring your app to ChatGPT

68 

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

70 

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

72 

73### Coordinate new-hire onboarding

74 

75Use Codex to gather approved new-hire context, stage tracker updates, draft team-by-team...

76 

77Integrations Data](https://developers.openai.com/codex/use-cases/new-hire-onboarding)[![](/images/codex/codex-wallpaper-2.webp)

78 

79### Create a CLI Codex can use

80 

81Ask Codex to create a composable CLI it can run from any folder, combine with repo scripts...

82 

83Engineering Code](https://developers.openai.com/codex/use-cases/agent-friendly-clis)