use-cases/github-code-reviews.md Codex Docs, 2026-04-10 18:23 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,

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

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

7Easy7skills:

8 8 - token: $security-best-practices

95s9 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

11Related links11 dependency changes.

12 12bestFor:

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

14 

15## Best for

16 

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

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

19 15starterPrompt:

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

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

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

23 19 suggestedModel: cloud

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

25 21 - label: Codex code review in GitHub

26## Starter prompt22 url: /codex/integrations/github

27 23 - label: Custom instructions with AGENTS.md

28@codex review for security regressions, missing tests, and risky behavior changes.24 url: /codex/guides/agents-md

25---

29 26 

30## How to use27## How to use

31 28 

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

33 31 

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

35 33 

37 35 

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

39 37 

40## Define additional guidance38## Define review guidance

41 39 

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

43 41 

51```49```

52 50 

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

54 

55## Related use cases

56 

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

58 

59### Bring your app to ChatGPT

60 

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

62 

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

64 

65### Coordinate new-hire onboarding

66 

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

68 

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

70 

71### Create a CLI Codex can use

72 

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

74 

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