OpenAI - Codex Docs Changes 2026-04-14 18:31 UTC → 2026-04-16 00:46 UTC

18 18 

19 [Download for macOS](https://persistent.oaistatic.com/codex-app-prod/Codex.dmg)19 [Download for macOS](https://persistent.oaistatic.com/codex-app-prod/Codex.dmg)

20 20 

21 Need a different operating system?

22 

23 [Download for Windows](https://get.microsoft.com/installer/download/9PLM9XGG6VKS?cid=website_cta_psi)

24 

21 [Get notified for Linux](https://openai.com/form/codex-app/)25 [Get notified for Linux](https://openai.com/form/codex-app/)

222. Open Codex and sign in262. Open Codex and sign in

23 27 

40- Build a classic Snake game in this repo.44- Build a classic Snake game in this repo.

41- Find and fix bugs in my codebase with minimal, high-confidence changes.45- Find and fix bugs in my codebase with minimal, high-confidence changes.

42 46 

43 If you need more inspiration, check out the [explore section](https://developers.openai.com/codex/explore).47 If you need more inspiration, explore [Codex use cases](https://developers.openai.com/codex/use-cases).

44 If you're new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).48 If you're new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).

45 49 

46---50---

16 16 

17Download and start building with Codex.17Download and start building with Codex.

18 18 

19 Get started](https://developers.openai.com/codex/quickstart) [### Explore19 Get started](https://developers.openai.com/codex/quickstart) [### Explore use cases

20 20 

21Get inspirations on what you can build with Codex.21Get inspiration on what you can build with Codex.

22 22 

23 Learn more](https://developers.openai.com/codex/explore) [### Community23 Learn more](https://developers.openai.com/codex/use-cases) [### Community

24 24 

25Read community posts, explore meetups, and connect with Codex builders.25Read community posts, explore meetups, and connect with Codex builders.

26 26 

14 14 

15 [Download for macOS](https://persistent.oaistatic.com/codex-app-prod/Codex.dmg)15 [Download for macOS](https://persistent.oaistatic.com/codex-app-prod/Codex.dmg)

16 16 

17 Need a different operating system?

18 

19 [Download for Windows](https://get.microsoft.com/installer/download/9PLM9XGG6VKS?cid=website_cta_psi)

20 

17 [Get notified for Linux](https://openai.com/form/codex-app/)21 [Get notified for Linux](https://openai.com/form/codex-app/)

182. Open Codex and sign in222. Open Codex and sign in

19 23 

35- Build a classic Snake game in this repo.39- Build a classic Snake game in this repo.

36- Find and fix bugs in my codebase with minimal, high-confidence changes.40- Find and fix bugs in my codebase with minimal, high-confidence changes.

37 41 

38 If you need more inspiration, check out the [explore section](https://developers.openai.com/codex/explore).42 If you need more inspiration, explore [Codex use cases](https://developers.openai.com/codex/use-cases).

39 If you’re new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).43 If you’re new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).

40 44 

41 [Learn more about the Codex app](https://developers.openai.com/codex/app)45 [Learn more about the Codex app](https://developers.openai.com/codex/app)

1# Create a CLI Codex can use | Codex use cases1# Create a CLI Codex can use | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Create a CLI Codex can use

12 

13Give Codex a composable command for an API, log source, export, or team script.

14 

15Difficulty **Intermediate**

16 

17Time horizon **1h**

18 

19Ask Codex to create a composable CLI it can run from any folder, combine with repo scripts, use to download files, and remember through a companion skill.

20 

21## Best for

22 

23- Repeated work where Codex needs to search, read, download from, or safely write to the same service, export, local archive, or repo script.

24- Agent tools that need paged search, exact reads by ID, predictable JSON, downloaded files, local indexes, or draft-before-write commands.

25 

26# Contents

27 

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

4 29 

5Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/agent-friendly-clis/?export=pdf)30Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/agent-friendly-clis/?export=pdf)

1# Upgrade your API integration | Codex use cases1# Upgrade your API integration | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Upgrade your API integration

12 

13Upgrade your app to the latest OpenAI API models.

14 

15Difficulty **Intermediate**

16 

17Time horizon **1h**

18 

19Use Codex to update your existing OpenAI API integration to the latest recommended models and API features, while checking for regressions before you ship.

20 

21## Best for

22 

23 - Teams upgrading from older models or API surfaces

24 - Repos that need behavior-preserving migrations with explicit validation

25 

26# Contents

27 

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

4 29 

5Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/api-integration-migrations/?export=pdf)30Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/api-integration-migrations/?export=pdf)

1# Understand large codebases | Codex use cases1# Understand large codebases | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Understand large codebases

12 

13Trace request flows, map unfamiliar modules, and find the right files fast.

14 

15Difficulty **Easy**

16 

17Time horizon **5m**

18 

19Use Codex to map unfamiliar codebases, explain different modules and data flow, and point you to the next files worth reading before you edit.

20 

21## Best for

22 

23 - New engineers onboarding to a new repo or service

24 - Anyone trying to understand how a feature works before changing it

25 

26# Contents

27 

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

4 29 

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

1# Build responsive front-end designs | Codex use cases1# Build responsive front-end designs | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Build responsive front-end designs

12 

13Turn screenshots and visual references into responsive UI with visual checks.

14 

15Difficulty **Intermediate**

16 

17Time horizon **1h**

18 

19Use Codex to translate screenshots and design briefs into code that matches the repo's design system, then use Playwright to compare the implementation to your references for different screen sizes and iterate until it looks right.

20 

21## Best for

22 

23 - Creating new front-end projects from scratch

24- Implementing already designed screens or flows from screenshots in an existing codebase

25 

26# Contents

27 

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

4 29 

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

1# Generate slide decks | Codex use cases1# Generate slide decks | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Generate slide decks

12 

13Manipulate pptx files and use image generation to automate slide creation.

14 

15Difficulty **Easy**

16 

17Time horizon **30m**

18 

19Use Codex to update existing presentations or build new decks by editing slides directly through code, generating visuals, and applying repeatable layout rules slide by slide.

20 

21## Best for

22 

23 - Teams turning notes or structured inputs into repeatable slide decks

24 - Creating new visual presentations from scratch

25- Rebuilding or extending decks from screenshots, PDFs, or reference presentations

26 

27# Contents

28 

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

4 30 

5Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/generate-slide-decks/?export=pdf)31Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/generate-slide-decks/?export=pdf)

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

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Review pull requests faster

12 

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 approval

24 - Large codebases for projects in production

25 

26# Contents

27 

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

4 29 

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

1# Iterate on difficult problems | Codex use cases1# Iterate on difficult problems | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Iterate on difficult problems

12 

13Use Codex as a scored improvement loop to solve hard tasks.

14 

15Difficulty **Advanced**

16 

17Time horizon **Long-running**

18 

19Give Codex an evaluation system, such as scripts and reviewable artifacts, so it can keep improving a hard task until the scores are good enough.

20 

21## Best for

22 

23- Problems where each iteration can be scored, but the best result usually takes many passes

24- Tasks with visual or subjective outputs that need both deterministic checks and an LLM-as-a-judge score

25- Long-running Codex sessions where you want progress tracked clearly instead of relying on context

26 

27# Contents

28 

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

4 30 

5Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/iterate-on-difficult-problems/?export=pdf)31Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/iterate-on-difficult-problems/?export=pdf)

1# Learn a new concept | Codex use cases1# Learn a new concept | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Learn a new concept

12 

13Turn dense source material into a clear, reviewable learning report.

14 

15Difficulty **Intermediate**

16 

17Time horizon **30m**

18 

19Use Codex to study material such as research papers or courses, split the reading across subagents, gather context, and produce a Markdown report with diagrams.

20 

21## Best for

22 

23 - Individuals learning about an unfamiliar concept

24- Dense source material that benefits from parallel reading, context gathering, diagrams, and a written synthesis

25- Turning a one-off reading session into a reusable Markdown report with citations, glossary terms

26 

27# Contents

28 

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

4 30 

5Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/learn-a-new-concept/?export=pdf)31Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/learn-a-new-concept/?export=pdf)

1# Coordinate new-hire onboarding | Codex use cases1# Coordinate new-hire onboarding | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Coordinate new-hire onboarding

12 

13Prepare onboarding trackers, team summaries, and welcome-space drafts.

14 

15Difficulty **Intermediate**

16 

17Time horizon **30m**

18 

19Use Codex to gather approved new-hire context, stage tracker updates, draft team-by-team summaries, and prepare welcome-space setup for review before anything is sent.

20 

21## Best for

22 

23- People, recruiting, IT, or workplace operations teams coordinating a batch of upcoming starts

24 - Managers preparing for new teammates and first-week handoffs

25- Coordinators turning a roster into a tracker, manager note, and welcome-space draft

26 

27# Contents

28 

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

4 30 

5Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/new-hire-onboarding/?export=pdf)31Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/new-hire-onboarding/?export=pdf)

1# Save workflows as skills | Codex use cases1# Save workflows as skills | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Save workflows as skills

12 

13Create a skill Codex can keep on hand for work you repeat.

14 

15Difficulty **Easy**

16 

17Time horizon **5m**

18 

19Turn a working Codex thread, review rules, test commands, release checklists, design conventions, writing examples, or repo-specific scripts into a skill Codex can use in future threads.

20 

21## Best for

22 

23 - Codified workflows you want Codex to use again.

24- Teams that want a reusable skill instead of a long prompt pasted into every thread.

25 

26# Contents

27 

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

4 29 

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

1# Kick off coding tasks from Slack | Codex use cases1# Kick off coding tasks from Slack | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Kick off coding tasks from Slack

12 

13Turn Slack threads into scoped cloud tasks.

14 

15Difficulty **Easy**

16 

17Time horizon **5m**

18 

19Mention `@Codex` in Slack to start a task tied to the right repo and environment, then review the result back in the thread or in Codex cloud.

20 

21## Best for

22 

23- Async handoffs that start in a Slack thread and already have enough context to act on

24- Teams that want quick issue triage, bug fixes, or scoped implementation work without context switching

25 

26# Contents

27 

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

4 29 

5Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/slack-coding-tasks/?export=pdf)30Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/slack-coding-tasks/?export=pdf)