app/settings.md Codex Docs, 2026-02-19 20:37 UTC → 2026-05-05 23:00 UTC

1# Codex app settings1# Codex app settings

2 2 

3Configure Codex app behavior and preferences

4 

5Use the settings panel to tune how the Codex app behaves, how it opens files,3Use the settings panel to tune how the Codex app behaves, how it opens files,

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

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

12require <kbd>Cmd</kbd>+<kbd>Enter</kbd> for multiline prompts or prevent sleep while a10require <kbd>Cmd</kbd>+<kbd>Enter</kbd> for multiline prompts or prevent sleep while a

13thread runs.11thread runs.

14 12 

15## Appearance

16 

17Pick a theme, decide whether the window is solid, and adjust UI or code fonts. Font

18choices apply across the app, including the diff review panel and terminal.

19 

20## Notifications13## Notifications

21 14 

22Choose when turn completion notifications appear, and whether the app should prompt for15Choose when turn completion notifications appear, and whether the app should prompt for

26 19 

27Codex agents in the app inherit the same configuration as the IDE and CLI extension.20Codex agents in the app inherit the same configuration as the IDE and CLI extension.

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

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

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

31 24 

25## Appearance

26 

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

28adjusting accent, background, and foreground colors, and changing the UI and code

29fonts. You can also share your custom theme with friends.

30 

31<CodexScreenshot

32 alt="Codex app Appearance settings showing theme selection, color controls, and font options"

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

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

35 maxHeight="720px"

36 class="mb-8"

37/>

38 

39### Codex pets

40 

41<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%)]">

42 <div>

43 Codex pets are optional animated companions for the app. In **Settings**,

44 go to **Appearance** and choose **Pets** to select a built-in pet or

45 refresh custom pets from your local Codex home. Type `/pet` in the

46 composer, use **Wake Pet** or **Tuck Away Pet** in **Settings > Appearance**, or

47 press <kbd>Cmd+K</kbd> or <kbd>Ctrl+K</kbd> and run the same commands to

48 toggle the floating overlay.

49 

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

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

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

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

54 

55 </div>

56 

57 <CodexPetsDemo client:load />

58</div>

59 

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

61 

62```text

63$skill-installer hatch-pet

64```

65 

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

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

68 

69```text

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

71```

72 

32## Git73## Git

33 74 

34Use Git settings to standardize branch naming and choose whether Codex uses force75Use Git settings to standardize branch naming and choose whether Codex uses force

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

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

44 85 

86## Browser use

87 

88Use these settings to install or enable the bundled Browser plugin and manage

89allowed and blocked websites. Codex asks before using a website unless you've

90allowed it. Removing a site from the blocked list lets Codex ask

91again before using it in the browser.

92 

93See [In-app browser](https://developers.openai.com/codex/app/browser) for browser preview, comment, and

94browser use workflows.

95 

96## Computer Use

97 

98On macOS, check your Computer Use settings to review desktop-app access and related

99preferences after setup. To revoke system-level access, update Screen Recording

100or Accessibility permissions in macOS Privacy & Security settings. The feature

101isn't available in the EEA, the United Kingdom, or Switzerland at launch.

102 

45## Personalization103## Personalization

46 104 

47Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use105Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use

50You can also add your own custom instructions. Editing custom instructions updates your108You can also add your own custom instructions. Editing custom instructions updates your

51[personal instructions in `AGENTS.md`](https://developers.openai.com/codex/guides/agents-md).109[personal instructions in `AGENTS.md`](https://developers.openai.com/codex/guides/agents-md).

52 110 

53## Archived threads111## Context-aware suggestions

54 112 

55The **Archived threads** section lists archived chats with dates and project113Use context-aware suggestions to surface follow-ups and tasks you may want to resume when you

56context. Use **Unarchive** to restore a thread.114start or return to Codex.

57 115 

58[Previous116## Memories

59 117 

60Features](https://developers.openai.com/codex/app/features)[Next118Enable Memories, where available, to let Codex carry useful context from past

119threads into future work. See [Memories](https://developers.openai.com/codex/memories) for setup, storage,

120and per-thread controls.

61 121 

62Review](https://developers.openai.com/codex/app/review)122## Archived threads

123 

124The **Archived threads** section lists archived chats with dates and project

125context. Use **Unarchive** to restore a thread.