app/settings.md Codex Docs, 2026-04-25 06:37 UTC → 2026-05-14 07:00 UTC

28adjusting accent, background, and foreground colors, and changing the UI and code28adjusting accent, background, and foreground colors, and changing the UI and code

29fonts. You can also share your custom theme with friends.29fonts. You can also share your custom theme with friends.

30 30 

31![Codex app Appearance settings showing theme selection, color controls, and font options](/images/codex/app/theme-selection-light.webp)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```

32 72 

33## Git73## Git

34 74 

45 85 

46## Browser use86## Browser use

47 87 

48Use these settings to install or enable the bundled Browser plugin and manage88Use these settings to install or enable the bundled Browser plugin, set up the

49allowlisted and blocklisted websites. Codex asks before using a website89[Codex Chrome extension](https://developers.openai.com/codex/app/chrome-extension), and manage allowlisted

50unless you’ve allowlisted it. Removing a site from the blocklist lets Codex ask90and blocklisted websites. Codex asks before using a website unless you've

51again before using it in the browser.91allowlisted it. Removing a site from the blocklist lets Codex ask again before

92using it in the browser.

52 93 

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

54browser use workflows.95browser use workflows.

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

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

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

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

62at launch.

63 103 

64## Personalization104## Personalization

65 105