app/settings.md Codex Docs, 2026-04-20 06:53 UTC → 2026-05-02 00:48 UTC

30 30 

31![Codex app Appearance settings showing theme selection, color controls, and font options](/images/codex/app/theme-selection-light.webp)31![Codex app Appearance settings showing theme selection, color controls, and font options](/images/codex/app/theme-selection-light.webp)

32 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 

33## Git63## Git

34 64 

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

43also 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

44`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.

45 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 

46## Computer Use86## Computer Use

47 87 

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

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

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

51isn’t available in the European Economic Area, the United Kingdom, or Switzerland91isn't available in the EEA, the United Kingdom, or Switzerland at launch.

52at launch.

53 92 

54## Personalization93## Personalization

55 94