The Codex app is a focused desktop experience for working on Codex threads in parallel, with built-in worktree support, automations, and Git functionality.
ChatGPT Plus, Pro, Business, Edu, and Enterprise plans include Codex. Learn more about what’s included.
The Codex app is available on macOS (Apple Silicon).
Download and install the Codex app
The Codex app is currently only available for macOS. 1.
Open Codex and sign in
Once you downloaded and installed the Codex app, open it and sign in with your ChatGPT account or an OpenAI API key.
If you sign in with an OpenAI API key, some functionality such as cloud threads might not be available. 1.
Select a project
Choose…
The Codex app is a focused desktop experience for working on Codex threads in parallel, with built-in worktree support, automations, and Git functionality.
ChatGPT Plus, Pro, Business, Edu, and Enterprise plans include Codex. Learn more about what’s included.
The Codex app is available on macOS (Apple Silicon).
Download and install the Codex app
The Codex app is currently only available for macOS. 1.
Open Codex and sign in
Once you downloaded and installed the Codex app, open it and sign in with your ChatGPT account or an OpenAI API key.
If you sign in with an OpenAI API key, some functionality such as cloud threads might not be available. 1.
Select a project
Choose a project folder that you want Codex to work in.
If you used the Codex app, CLI, or IDE Extension before you’ll see past projects that you worked on.
Send your first message
After choosing the project, make sure Local is selected to have Codex work on your machine and send your first message to Codex.
You can ask Codex anything about the project or your computer in general. Here are some examples:
If you need more inspiration, check out the explore section.
Multitask across projectsRun multiple tasks in parallel and switch quickly between them.Built-in Git toolsReview diffs, comment inline, stage or revert chunks, and commit without leaving the app.Worktrees for parallel tasksIsolate changes of multiple Codex threads using built-in Git worktree support.Skills supportGive your Codex agent additional capabilities and reuse skills across App, CLI, and IDE Extension.AutomationsPair skills with automations to automate recurring tasks in the background. Codex adds findings to the inbox, or automatically archives runs if there’s nothing to report.Built-in terminalOpen a terminal per thread to test your changes, run dev servers, scripts, and custom commands.Local environmentsDefine worktree setup scripts and common project actions for easy access.Sync with the IDE extensionShare Auto Context and active threads across app and IDE sessions.MCP supportConnect your Codex agent to additional services using MCP.
Need help? Visit the troubleshooting guide.