app/settings.md +53 −3
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
3131<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
43also apply to the Codex CLI and IDE extension because the MCP configuration lives in83also 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.84`config.toml`. See the [Model Context Protocol docs](https://developers.openai.com/codex/mcp) for details.
45 85
86## Browser use
87
88Use these settings to install or enable the bundled Browser plugin, set up the
89[Codex Chrome extension](https://developers.openai.com/codex/app/chrome-extension), and manage allowlisted
90and blocklisted websites. Codex asks before using a website unless you've
91allowlisted it. Removing a site from the blocklist lets Codex ask again before
92using it in the browser.
93
94See [In-app browser](https://developers.openai.com/codex/app/browser) for browser preview, comment, and
95browser use workflows.
96
46## Computer Use97## Computer Use
47 98
48On 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
49preferences after setup. To revoke system-level access, update Screen Recording100preferences after setup. To revoke system-level access, update Screen Recording
50or Accessibility permissions in macOS Privacy & Security settings. The feature101or Accessibility permissions in macOS Privacy & Security settings. The feature
51102isn’t available in the European Economic Area, the United Kingdom, or Switzerlandisn't available in the EEA, the United Kingdom, or Switzerland at launch.
52at launch.
53 103
54## Personalization104## Personalization
55 105