app/settings.md +9 −14
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
2922options. See [Codex security](https://developers.openai.com/codex/security) andoptions. 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
32
32## Git33## Git
33 34
34Use Git settings to standardize branch naming and choose whether Codex uses force35Use Git settings to standardize branch naming and choose whether Codex uses force
54 55
55The **Archived threads** section lists archived chats with dates and project56The **Archived threads** section lists archived chats with dates and project
56context. Use **Unarchive** to restore a thread.57context. Use **Unarchive** to restore a thread.
57
58[Previous
59
60Features](https://developers.openai.com/codex/app/features)[Next
61
62Review](https://developers.openai.com/codex/app/review)