use-cases/github-code-reviews.md +75 −0 added
1# Review pull requests faster | Codex use cases
2
3[← All use cases](https://developers.openai.com/codex/use-cases)
4
5Use Codex in GitHub to automatically surface regressions, missing tests, and documentation issues directly on a pull request.
6
7Easy
8
95s
10
11Related links
12
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 approval
18 - Large codebases for projects in production
19
20## Skills & Plugins
21
22- [Security Best Practices](https://github.com/openai/skills/tree/main/skills/.curated/security-best-practices)
23
24 Focus the review on risky surfaces such as secrets, auth, and dependency changes.
25
26## Starter prompt
27
28@codex review for security regressions, missing tests, and risky behavior changes.
29
30## How to use
31
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.
33
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.
35
36If 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`.
37
38This will start a new cloud task that will fix the issue and update the pull request.
39
40## Define additional guidance
41
42To customize what Codex reviews, add or update a top-level `AGENTS.md` with a section like this:
43
44```md
45## Review guidelines
46
47- Flag typos and grammar issues as P0 issues.
48- Flag potential missing documentation as P1 issues.
49- Flag missing tests as P1 issues.
50 ...
51```
52
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.
54
55## Related use cases
56
57[
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)[
64
65### Generate slide decks
66
67Use Codex to update existing presentations or build new decks by editing slides directly...
68
69Data Workflow](https://developers.openai.com/codex/use-cases/generate-slide-decks)[
70
71### Kick off coding tasks from Slack
72
73Mention `@Codex` in Slack to start a task tied to the right repo and environment, then...
74
75Integrations Workflow](https://developers.openai.com/codex/use-cases/slack-coding-tasks)