app/settings.md Codex Docs, 2026-04-23 00:46 UTC → 2026-05-02 06:45 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**,

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

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

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

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

40 toggle the floating overlay.

41 

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

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

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

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

46 

471/8

48 

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

50 

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

52 

53```text

54$skill-installer hatch-pet

55```

56 

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

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

59 

60```text

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

62```

63 

33## Git64## Git

34 65 

35Use Git settings to standardize branch naming and choose whether Codex uses force66Use 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 in74also 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.75`config.toml`. See the [Model Context Protocol docs](https://developers.openai.com/codex/mcp) for details.

45 76 

77## Browser use

78 

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

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

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

82again before using it in the browser.

83 

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

85browser use workflows.

86 

46## Computer Use87## Computer Use

47 88 

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

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

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

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

52at launch.

53 93 

54## Personalization94## Personalization

55 95