app/settings.md +59 −0
30 30
3131
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
87## Computer Use
88
89On macOS, check your Computer Use settings to review desktop-app access and related
90preferences after setup. To revoke system-level access, update Screen Recording
91or Accessibility permissions in macOS Privacy & Security settings. The feature
92isn't available in the EEA, the United Kingdom, or Switzerland at launch.
93
46## Personalization94## Personalization
47 95
48Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use96Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use
51You can also add your own custom instructions. Editing custom instructions updates your99You can also add your own custom instructions. Editing custom instructions updates your
52[personal instructions in `AGENTS.md`](https://developers.openai.com/codex/guides/agents-md).100[personal instructions in `AGENTS.md`](https://developers.openai.com/codex/guides/agents-md).
53 101
102## Context-aware suggestions
103
104Use context-aware suggestions to surface follow-ups and tasks you may want to resume when you
105start or return to Codex.
106
107## Memories
108
109Enable Memories, where available, to let Codex carry useful context from past
110threads into future work. See [Memories](https://developers.openai.com/codex/memories) for setup, storage,
111and per-thread controls.
112
54## Archived threads113## Archived threads
55 114
56The **Archived threads** section lists archived chats with dates and project115The **Archived threads** section lists archived chats with dates and project