app/settings.md Codex Docs, 2026-03-07 18:10 UTC → 2026-05-02 00:48 UTC

10require <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

11thread runs.11thread runs.

12 12 

13## Appearance

14 

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

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

17 

18## Notifications13## Notifications

19 14 

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

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

28[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.

29 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![Codex app Appearance settings showing theme selection, color controls, and font options](/images/codex/app/theme-selection-light.webp)

32 

33### Codex pets

34 

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

36choose **Pets** to select a built-in pet or refresh custom pets from your

37local Codex home. Type `/pet` in the composer, use **Wake Pet** or **Tuck Away Pet** in Settings, or

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

39 toggle the floating overlay.

40 

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

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

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

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

45 

461/8

47 

48CodexI found a tiny loose thread in settings. Want me to tug it?

49 

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

51 

52```text

53$skill-installer hatch-pet

54```

55 

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

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

58 

59```text

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

61```

62 

30## Git63## Git

31 64 

32Use Git settings to standardize branch naming and choose whether Codex uses force65Use Git settings to standardize branch naming and choose whether Codex uses force

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

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

42 75 

76## Browser use

77 

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

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

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

81again before using it in the browser.

82 

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

84browser use workflows.

85 

86## Computer Use

87 

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

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

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

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

92 

43## Personalization93## Personalization

44 94 

45Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use95Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use

48You can also add your own custom instructions. Editing custom instructions updates your98You can also add your own custom instructions. Editing custom instructions updates your

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

50 100 

101## Context-aware suggestions

102 

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

104start or return to Codex.

105 

106## Memories

107 

108Enable Memories, where available, to let Codex carry useful context from past

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

110and per-thread controls.

111 

51## Archived threads112## Archived threads

52 113 

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