app/settings.md Codex Docs, 2026-04-29 00:50 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

46## Browser use77## Browser use

47 78 

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

49allowlisted and blocklisted websites. Codex asks before using a website80allowed and blocked websites. Codex asks before using a website unless you've

50unless you’ve allowlisted it. Removing a site from the blocklist lets Codex ask81allowed it. Removing a site from the blocked list lets Codex ask

51again before using it in the browser.82again before using it in the browser.

52 83 

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

58On 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

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

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

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

62at launch.

63 93 

64## Personalization94## Personalization

65 95