1# Codex app1# App – Codex
2 2
3The Codex app is a focused desktop experience for working on Codex threads in parallel, with built-in worktree support, automations, and Git functionality.3The Codex app is a focused desktop experience for working on Codex threads in parallel, with built-in worktree support, automations, and Git functionality.
4 4
5ChatGPT Plus, Pro, Business, Edu, and Enterprise plans include Codex. Learn more about [what's included](https://developers.openai.com/codex/pricing).5ChatGPT Plus, Pro, Business, Edu, and Enterprise plans include Codex. Learn more about [what’s included](https://developers.openai.com/codex/pricing).
6 6
7<PlatformSpecificContent>7
8 <CodexScreenshot8
9 slot="windows"9
10 alt="Codex app for Windows showing a project sidebar, active thread, and review pane"
11 lightSrc="/images/codex/windows/codex-windows-light.webp"
12 darkSrc="/images/codex/windows/codex-windows-dark.webp"
13 variant="no-wallpaper"
14 maxHeight="300px"
15 />
16 <CodexScreenshot
17 alt="Codex app window with a project sidebar, active thread, and review pane"
18 lightSrc="/images/codex/app/app-screenshot-light.webp"
19 darkSrc="/images/codex/app/app-screenshot-dark.webp"
20 variant="no-wallpaper"
21 maxHeight="300px"
22 />
23</PlatformSpecificContent>
24 10
25## Getting started11## Getting started
26 12
29Most Codex app features are available on both platforms. Platform-specific15Most Codex app features are available on both platforms. Platform-specific
30exceptions are noted in the relevant docs.16exceptions are noted in the relevant docs.
31 17
32<WorkflowSteps variant="headings">
331. Download and install the Codex app181. Download and install the Codex app
34 19
35 Download the Codex app for macOS or Windows. Choose the Intel build if you're using an Intel-based Mac.20 Download the Codex app for macOS or Windows. Choose the Intel build if you’re using an Intel-based Mac.
36 21
37 <CodexAppDownloadCta client:load className="mb-4" />22 [Download for macOS (Apple Silicon)](https://persistent.oaistatic.com/codex-app-prod/Codex.dmg)[Download for macOS (Intel)](https://persistent.oaistatic.com/codex-app-prod/Codex-latest-x64.dmg)
38 23
39 <div class="text-sm">24 Need a different operating system?
40 [Get notified for Linux](https://openai.com/form/codex-app/)
41 </div>
42 25
26 [Download for Windows](https://get.microsoft.com/installer/download/9PLM9XGG6VKS?cid=website_cta_psi)
27
28 [Get notified for Linux](https://openai.com/form/codex-app/)
432. Open Codex and sign in292. Open Codex and sign in
44 30
45 Once you downloaded and installed the Codex app, open it and sign in with your ChatGPT account or an OpenAI API key.31 Once you downloaded and installed the Codex app, open it and sign in with your ChatGPT account or an OpenAI API key.
50 35
51 Choose a project folder that you want Codex to work in.36 Choose a project folder that you want Codex to work in.
52 37
53If you used the Codex app, CLI, or IDE Extension before you'll see past projects that you worked on.38If you used the Codex app, CLI, or IDE Extension before you’ll see past projects that you worked on.
54 39
554. Send your first message404. Send your first message
56 41
58 43
59 You can ask Codex anything about the project or your computer in general. Here are some examples:44 You can ask Codex anything about the project or your computer in general. Here are some examples:
60 45
61 <ExampleGallery>46- Tell me about this project
62 <ExampleTask47- Build a classic Snake game in this repo.
63 client:load48- Find and fix bugs in my codebase with minimal, high-confidence changes.
64 id="intro"
65 prompt="Tell me about this project"
66 iconName="brain"
67 />
68 <ExampleTask
69 client:load
70 id="snake-game"
71 shortDescription="Build a classic Snake game in this repo."
72 prompt={[
73 "Build a classic Snake game in this repo.",
74 "",
75 "Scope & constraints:",
76 "- Implement ONLY the classic Snake loop: grid movement, growing snake, food spawn, score, game-over, restart.",
77 "- Reuse existing project tooling/frameworks; do NOT add new dependencies unless truly required.",
78 "- Keep UI minimal and consistent with the repo’s existing styles (no new design systems, no extra animations).",
79 "",
80 "Implementation plan:",
81 "1) Inspect the repo to find the right place to add a small interactive game (existing pages/routes/components).",
82 "2) Implement game state (snake positions, direction, food, score, tick timer) with deterministic, testable logic.",
83 "3) Render: simple grid + snake + food; support keyboard controls (arrow keys/WASD) and on-screen controls if mobile is present in the repo.",
84 "4) Add basic tests for the core game logic (movement, collisions, growth, food placement) if the repo has a test runner.",
85 "",
86 "Deliverables:",
87 "- A small set of files/changes with clear names.",
88 "- Short run instructions (how to start dev server + where to navigate).",
89 "- A brief checklist of what to manually verify (controls, pause/restart, boundaries).",
90 ].join("\n")}
91 iconName="gamepad"
92 />
93 <ExampleTask
94 client:load
95 id="fix-bugs"
96 shortDescription="Find and fix bugs in my codebase with minimal, high-confidence changes."
97 prompt={[
98 "Find and fix bugs in my codebase with minimal, high-confidence changes.",
99 "",
100 "Method (grounded + disciplined):",
101 "1) Reproduce: run tests/lint/build (or follow the existing repo scripts). If I provided an error, reproduce that exact failure.",
102 "2) Localize: identify the smallest set of files/lines involved (stack traces, failing tests, logs).",
103 "3) Fix: implement the minimal change that resolves the issue without refactors or unrelated cleanup.",
104 "4) Prove: add/update a focused test (or a tight repro) that fails before and passes after.",
105 "",
106 "Constraints:",
107 "- Do NOT invent errors or pretend to run commands you cannot run.",
108 "- No scope drift: no new features, no UI embellishments, no style overhauls.",
109 "- If information is missing, state what you can confirm from the repo and what remains unknown.",
110 "",
111 "Output:",
112 "- Summary (3–6 sentences max): what was broken, why, and the fix.",
113 "- Then ≤5 bullets: What changed, Where (paths), Evidence (tests/logs), Risks, Next steps.",
114 ].join("\n")}
115 iconName="search"
116 />
117 </ExampleGallery>
118 49
119 If you need more inspiration, explore [Codex use cases](https://developers.openai.com/codex/use-cases).50 If you need more inspiration, explore [Codex use cases](https://developers.openai.com/codex/use-cases).
120 If you're new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).51 If you’re new to Codex, read the [best practices guide](https://developers.openai.com/codex/learn/best-practices).
121
122</WorkflowSteps>
123 52
124---53---
125 54
126## Work with the Codex app55## Work with the Codex app
127 56
128<BentoContainer class="mt-6">57[### Multitask across projects
129 <BentoContent href="/codex/app/features#multitask-across-projects">
130
131### Multitask across projects
132
133Run project threads side by side and switch between them quickly.
134 58
135 </BentoContent>59Run project threads side by side and switch between them quickly.](https://developers.openai.com/codex/app/features#multitask-across-projects)[### Worktrees
136 <BentoContent href="/codex/app/worktrees">
137 60
138### Worktrees61Keep parallel code changes isolated with built-in Git worktree support.](https://developers.openai.com/codex/app/worktrees)[### Remote connections
139
140Keep parallel code changes isolated with built-in Git worktree support.
141
142 </BentoContent>
143 <BentoContent href="/codex/remote-connections">
144
145### Remote connections
146 62
147Use the ChatGPT mobile app to start, steer, approve, and review Codex work on a63Use the ChatGPT mobile app to start, steer, approve, and review Codex work on a
148connected host.64connected host.](https://developers.openai.com/codex/remote-connections)[### Computer use
149
150 </BentoContent>
151 <BentoContent href="/codex/app/computer-use">
152
153### Computer use
154
155Let Codex use macOS apps for GUI tasks, browser flows, and native app testing.
156
157 </BentoContent>
158 <BentoContent href="/codex/app/review">
159
160### Review and ship changes
161
162Inspect diffs, address PR feedback, stage files, commit, and push.
163 65
164 </BentoContent>66Let Codex use macOS apps for GUI tasks, browser flows, and native app testing.](https://developers.openai.com/codex/app/computer-use)[### Review and ship changes
165 <BentoContent href="/codex/app/features#integrated-terminal">
166 67
167### Terminal and actions68Inspect diffs, address PR feedback, stage files, commit, and push.](https://developers.openai.com/codex/app/review)[### Terminal and actions
168 69
169Run commands in each thread and launch repeatable project actions.70Run commands in each thread and launch repeatable project actions.](https://developers.openai.com/codex/app/features#integrated-terminal)[### In-app browser
170 71
171 </BentoContent>72Open rendered pages, leave comments, or let Codex operate local browser flows.](https://developers.openai.com/codex/app/browser)[### Chrome extension
172 <BentoContent href="/codex/app/browser">
173 73
174### In-app browser74Add the Chrome plugin so Codex can use Chrome for signed-in browser tasks while you manage website approvals.](https://developers.openai.com/codex/app/chrome-extension)[### Image generation
175 75
176Open rendered pages, leave comments, or let Codex operate local browser flows.76Generate or edit images in a thread while you work on the surrounding code and assets.](https://developers.openai.com/codex/app/features#image-generation)[### Automations
177 77
178 </BentoContent>78Schedule recurring tasks, or wake up the same thread for ongoing checks.](https://developers.openai.com/codex/app/automations)[### Skills
179 <BentoContent href="/codex/app/chrome-extension">
180 79
181### Chrome extension80Reuse instructions and workflows across the app, CLI, and IDE Extension.](https://developers.openai.com/codex/app/features#skills-support)[### Sidebar and artifacts
182 81
183Add the Chrome plugin so Codex can use Chrome for signed-in browser tasks while you manage website approvals.82Follow plans, sources, task summaries, and generated file previews.](https://developers.openai.com/codex/app/features#richer-outputs-and-artifacts)[### Plugins
184 83
185 </BentoContent>84Connect apps, skills, and MCP servers to extend what Codex can do.](https://developers.openai.com/codex/plugins)[### IDE Extension sync
186 <BentoContent href="/codex/app/features#image-generation">
187 85
188### Image generation86Share Auto Context and active threads across app and IDE sessions.](https://developers.openai.com/codex/app/features#sync-with-the-ide-extension)
189
190Generate or edit images in a thread while you work on the surrounding code and assets.
191
192 </BentoContent>
193 <BentoContent href="/codex/app/automations">
194
195### Automations
196
197Schedule recurring tasks, or wake up the same thread for ongoing checks.
198
199 </BentoContent>
200 <BentoContent href="/codex/app/features#skills-support">
201
202### Skills
203
204Reuse instructions and workflows across the app, CLI, and IDE Extension.
205
206 </BentoContent>
207 <BentoContent href="/codex/app/features#richer-outputs-and-artifacts">
208
209### Sidebar and artifacts
210
211Follow plans, sources, task summaries, and generated file previews.
212
213 </BentoContent>
214 <BentoContent href="/codex/plugins">
215
216### Plugins
217
218Connect apps, skills, and MCP servers to extend what Codex can do.
219
220 </BentoContent>
221 <BentoContent href="/codex/app/features#sync-with-the-ide-extension">
222
223### IDE Extension sync
224
225Share Auto Context and active threads across app and IDE sessions.
226
227 </BentoContent>
228</BentoContainer>
229 87
230---88---
231 89
