Settings

Use the settings panel to personalize the app and manage everyday preferences. Open Settings from the app menu or press

Cmd+, on macOS or Ctrl+, on Windows.

General

Require Cmd+Enter for multiline prompts, or turn on Prevent sleep while running so local tasks can continue while you step away. Under Follow-up behavior, choose whether a message sent while ChatGPT works should steer the current run or wait for the next run.

Profile

Use Profile to review activity insights, lifetime tokens, peak tokens, streaks, your longest task, and token activity. You can also update your profile details, such as your picture, display name, and username, and save a profile card with usage highlights. Sharing profile cards is available on consumer ChatGPT plans.

Eligible users can also send Codex invitations from the profile menu. Choose Invite a friend on an eligible personal plan or Invite a coworker in an eligible Business workspace. See Invite friends and coworkers for current rewards, limits, and eligibility.

Keyboard shortcuts

Open Keyboard Shortcuts to review commands, change bindings, or reset custom shortcuts to their defaults. Use the search field to find shortcuts by command name, or switch to keystroke search and press a key combination to find the command that uses it.

Notifications

Choose when turn completion notifications appear, and whether the app should prompt for notification permissions.

Appearance

In Settings, you can change the app appearance by choosing a base theme, adjusting accent, background, and foreground colors, and changing the UI and code fonts. You can also share your custom theme with friends.

Pets

Pets are optional animated companions for the app. In **Settings > Pets**, choose a built-in or custom pet, then use `/pet`, **Wake Pet**, or **Tuck Away Pet** to control the floating overlay.

See [Pets](https://learn.chatgpt.com/docs/pets?surface=app) to understand pet status, follow
activity across tasks, or create your own pet.

Browser

Use these settings to install or enable the bundled Browser plugin, set up the Chrome extension, and manage allowed and blocked websites. ChatGPT asks before using a website unless you've allowed it. Removing a blocked site lets ChatGPT ask again before using it in the browser.

See Built-in browser for browser preview, comment, and Computer Use workflows.

Computer Use

Check your Computer Use settings to review desktop-app access and related preferences after setup. On macOS, revoke system-level access by updating Screen Recording or Accessibility permissions in macOS Privacy & Security settings.

Personalization

Choose Friendly, Pragmatic, or None as your default personality. Use None to disable personality instructions. You can update this at any time.

You can also add your own custom instructions. Editing custom instructions updates your personal instructions in AGENTS.md.

Suggested prompts

Use context-aware suggestions to surface follow-ups and tasks you may want to resume when you start or return to ChatGPT.

Memories

Enable Memories, where available, to let ChatGPT carry useful context from past chats and tasks into future work. See Memories for setup, storage, and controls for individual chats and tasks.

Archived tasks

The Archived tasks section lists archived tasks with dates and project context. Use Unarchive to restore a task.

Keep a task near your work

In the ChatGPT desktop app, pop out an active task into a separate window and place it next to your browser, editor, or design preview. Turn on Always on top when you want the task to remain visible while you work in another app.

app/settings.md +51 −77

~~1# Codex app settings~~1# Settings

2 2

~~3Use the settings panel to tune how the Codex app behaves, how it opens files,~~3Use the settings panel to personalize the app and manage everyday preferences.

~~4and how it connects to tools. Open [**Settings**](codex://settings) from the app menu or~~4Open [**Settings**](codex://settings) from the app menu or press

~~5press <kbd>Cmd</kbd>+<kbd>,</kbd>.~~5

6<kbd>Cmd</kbd>+<kbd>,</kbd> on macOS or <kbd>Ctrl</kbd>+<kbd>,</kbd> on Windows.

6 7

7## General8## General

8 9

~~9Choose where files open, how much command output appears in threads, and where~~10Require <kbd>Cmd</kbd>+<kbd>Enter</kbd> for multiline prompts, or turn on

~~10terminal tabs open by default. You can also require <kbd>Cmd</kbd>+<kbd>Enter</kbd>~~11**Prevent sleep while running** so local tasks can continue while you step away.

~~11for multiline prompts or prevent sleep while a thread runs.~~12Under **Follow-up behavior**, choose whether a message sent while ChatGPT works

13should steer the current run or wait for the next run.

12 14

13## Profile15## Profile

14 16

21Eligible users can also send Codex invitations from the profile menu. Choose23Eligible users can also send Codex invitations from the profile menu. Choose

22**Invite a friend** on an eligible personal plan or **Invite a coworker** in an24**Invite a friend** on an eligible personal plan or **Invite a coworker** in an

23eligible Business workspace. See25eligible Business workspace. See

~~24[Invite friends and coworkers](https://developers.openai.com/codex/pricing#invite-friends-and-coworkers) for~~26[Invite friends and coworkers](https://learn.chatgpt.com/docs/pricing#invite-friends-and-coworkers) for

25current rewards, limits, and eligibility.27current rewards, limits, and eligibility.

26 28

27## Keyboard shortcuts29## Keyboard shortcuts

36Choose when turn completion notifications appear, and whether the app should prompt for38Choose when turn completion notifications appear, and whether the app should prompt for

37notification permissions.39notification permissions.

38 40

~~39## Agent configuration~~

~~41Codex agents in the app inherit the same configuration as the IDE and CLI extension.~~

~~42Use the in-app controls for common settings, or edit `config.toml` for advanced~~

~~43options. See [Codex security](https://developers.openai.com/codex/agent-approvals-security) and~~

~~44[config basics](https://developers.openai.com/codex/config-basic) for more detail.~~

46## Appearance41## Appearance

47 42

~~48In **Settings**, you can change the Codex app appearance by choosing a base theme,~~43In **Settings**, you can change the app appearance by choosing a base theme,

~~49adjusting accent, background, and foreground colors, and changing the UI and code~~44adjusting accent, background, and foreground colors, and changing the UI and

~~50fonts. You can also share your custom theme with friends.~~45code fonts. You can also share your custom theme with friends.

51 46

52<CodexScreenshot47<CodexScreenshot

~~53 alt="Codex app Appearance settings showing theme selection, color controls, and font options"~~48 alt="ChatGPT desktop app Appearance settings showing theme selection, color controls, and font options"

54 lightSrc="/images/codex/app/theme-selection-light.webp"49 lightSrc="/images/codex/app/theme-selection-light.webp"

55 darkSrc="/images/codex/app/theme-selection-dark.webp"50 darkSrc="/images/codex/app/theme-selection-dark.webp"

56 maxHeight="720px"51 maxHeight="720px"

57 class="mb-8"52 class="mb-8"

58/>53/>

59 54

~~60### Codex pets~~55## Pets

61 56

62<div class="grid gap-5 md:grid-cols-[minmax(0,1fr)_minmax(15rem,50%)] md:items-start xl:grid-cols-[minmax(0,1fr)_minmax(16rem,30%)]">57<div class="grid gap-5 md:grid-cols-[minmax(0,1fr)_minmax(15rem,50%)] md:items-start xl:grid-cols-[minmax(0,1fr)_minmax(16rem,30%)]">

63 <div>58 <div>

~~64 Codex pets are optional animated companions for the app. In **Settings**,~~59 Pets are optional animated companions for the app. In **Settings > Pets**,

~~65 go to **Appearance** and choose **Pets** to select a built-in pet or~~60 choose a built-in or custom pet, then use `/pet`, **Wake Pet**, or

~~66 refresh custom pets from your local Codex home. Type `/pet` in the~~61 **Tuck Away Pet** to control the floating overlay.

~~67 composer, use **Wake Pet** or **Tuck Away Pet** in **Settings > Appearance**, or~~62

~~68 press <kbd>Cmd+K</kbd> or <kbd>Ctrl+K</kbd> and run the same commands to~~63 See [Pets](https://learn.chatgpt.com/docs/pets?surface=app) to understand pet status, follow

~~69 toggle the floating overlay.~~64 activity across tasks, or create your own pet.

~~71 The overlay keeps active Codex work visible while you use other apps. It~~

~~72 shows the active thread, reflects whether Codex is running, waiting for~~

~~73 input, or ready for review, and pairs that state with a short progress~~

~~74 prompt so you can glance at what changed without reopening the thread.~~

75 65

76 </div>66 </div>

77 67

78 <CodexPetsDemo client:load />68 <CodexPetsDemo client:load />

79</div>69</div>

80 70

~~81To create your own pet, install the `hatch-pet` skill:~~

~~83```text~~

~~84$skill-installer hatch-pet~~

~~85```~~

~~87Reload skills from the command menu. Press <kbd>Cmd+K</kbd> or <kbd>Ctrl+K</kbd>,~~

~~88choose **Force Reload Skills**, then ask the skill to create a pet:~~

~~90```text~~

~~91$hatch-pet create a new pet inspired by my recent projects~~

~~92```~~

~~94## Git~~

~~96Use Git settings to standardize branch naming and choose whether Codex uses force~~

~~97pushes.~~

~~98You can also set prompts that Codex uses to generate commit messages and pull request descriptions.~~

100## Integrations & MCP

~~101~~

102Connect external tools via MCP (Model Context Protocol). Enable recommended servers or

103add your own. If a server requires OAuth, the app starts the auth flow. These settings

104also apply to the Codex CLI and IDE extension because the MCP configuration lives in

105`config.toml`. See the [Model Context Protocol docs](https://developers.openai.com/codex/mcp) for details.

~~106~~

107<a id="browser-use"></a>71<a id="browser-use"></a>

108 72

109## Browser73## Browser

110 74

111Use these settings to install or enable the bundled Browser plugin, set up the75Use these settings to install or enable the bundled Browser plugin, set up the

112[Codex Chrome extension](https://developers.openai.com/codex/app/chrome-extension), and manage allowed and76[Chrome extension](https://learn.chatgpt.com/docs/chrome-extension), and manage allowed and blocked

113blocked websites. Codex asks before using a website unless you've allowed it.77websites. ChatGPT asks before using a website unless you've allowed it. Removing

114Removing a blocked site lets Codex ask again before using it in the browser.78a blocked site lets ChatGPT ask again before using it in the browser.

~~115~~

116Under **Developer mode**, turn on **Enable full CDP access** to let Codex use

117the Chrome DevTools Protocol for performance profiling and deeper browser

118debugging. If your organization has disabled full CDP access, you can't enable

119it locally. See [Developer mode](https://developers.openai.com/codex/app/browser#developer-mode) for setup,

120risk, approval details, and the administrator requirement.

121 79

122See [In-app browser](https://developers.openai.com/codex/app/browser) for browser preview, comment, and80See [Built-in browser](https://learn.chatgpt.com/docs/browser?surface=app) for browser preview, comment, and

123browser use workflows.81Computer Use workflows.

124 82

125## Computer Use83## Computer Use

126 84

134**None** to disable personality instructions. You can update this at any time.92**None** to disable personality instructions. You can update this at any time.

135 93

136You can also add your own custom instructions. Editing custom instructions updates your94You can also add your own custom instructions. Editing custom instructions updates your

137[personal instructions in `AGENTS.md`](https://developers.openai.com/codex/guides/agents-md).95[personal instructions in `AGENTS.md`](https://learn.chatgpt.com/docs/agent-configuration/agents-md).

138 96

139## Context-aware suggestions97## Suggested prompts

140 98

141Use context-aware suggestions to surface follow-ups and tasks you may want to resume when you99Use context-aware suggestions to surface follow-ups and tasks you may want to resume when you

142start or return to Codex.100start or return to ChatGPT.

143 101

144## Memories102## Memories

145 103

146Enable Memories, where available, to let Codex carry useful context from past104Enable Memories, where available, to let ChatGPT carry useful context from past

147threads into future work. See [Memories](https://developers.openai.com/codex/memories) for setup, storage,105chats and tasks into future work. See [Memories](https://learn.chatgpt.com/docs/customization/memories)

148and per-thread controls.106for setup, storage, and controls for individual chats and tasks.

107

108## Archived tasks

109

110The **Archived tasks** section lists archived tasks with dates and project

111context. Use **Unarchive** to restore a task.

149 112

150## Archived threads113<a id="keep-an-app-chat-near-your-work"></a>

151 114

152The **Archived threads** section lists archived chats with dates and project115## Keep a task near your work

153context. Use **Unarchive** to restore a thread.116

117In the ChatGPT desktop app, pop out an active task into a separate window and place it

118next to your browser, editor, or design preview. Turn on **Always on top** when

119you want the task to remain visible while you work in another app.

120

121<CodexScreenshot

122 alt="ChatGPT desktop app task displayed in a floating pop-out window"

123 lightSrc="/images/codex/app/popover-light.webp"

124 darkSrc="/images/codex/app/popover-dark.webp"

125 maxHeight="400px"

126 class="my-8"

127/>