app/settings.md +76 −5
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<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
30## Git73## Git
31 74
32Use Git settings to standardize branch naming and choose whether Codex uses force75Use 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 in83also 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.84`config.toml`. See the [Model Context Protocol docs](https://developers.openai.com/codex/mcp) for details.
42 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
43## Personalization103## Personalization
44 104
45Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use105Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use
48You can also add your own custom instructions. Editing custom instructions updates your108You 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).109[personal instructions in `AGENTS.md`](https://developers.openai.com/codex/guides/agents-md).
50 110
111## Context-aware suggestions
112
113Use context-aware suggestions to surface follow-ups and tasks you may want to resume when you
114start or return to Codex.
115
116## Memories
117
118Enable 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.
121
51## Archived threads122## Archived threads
52 123
53The **Archived threads** section lists archived chats with dates and project124The **Archived threads** section lists archived chats with dates and project