use-cases/github-code-reviews.md Codex Docs, 2026-03-06 00:38 UTC → 2026-04-15 06:44 UTC

1# Review pull requests faster | Codex use cases

2 

3[← All use cases](https://developers.openai.com/codex/use-cases)

4 

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

6 

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

8 

9Easy

10 

115s

12 

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 approval

20 - Large codebases for projects in production

21 

22## Skills & Plugins

23 

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

25 

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

27 

28| Skill | Why use it |

29| --- | --- |

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

31 

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 

38## How to use

39 

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.

41 

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.

43 

44If Codex flags a regression or potential issue, you can ask it to fix it by commenting on the pull request with a follow-up prompt like `@codex fix it`.

45 

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

47 

48## Define additional guidance

49 

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

51 

52```md

53## Review guidelines

54 

55- Flag typos and grammar issues as P0 issues.

56- Flag potential missing documentation as P1 issues.

57- Flag missing tests as P1 issues.

58 ...

59```

60 

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.

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)