app/settings.md +58 −0
30 30
3131
32 32
33### Codex pets
34
35 Codex pets are optional animated companions for the app. In **Settings**,
36choose **Pets** to select a built-in pet or refresh custom pets from your
37local Codex home. Type `/pet` in the composer, use **Wake Pet** or **Tuck Away Pet** in Settings, or
38 press <kbd>Cmd+K</kbd> or <kbd>Ctrl+K</kbd> and run the same commands to
39 toggle the floating overlay.
40
41 The overlay keeps active Codex work visible while you use other apps. It
42 shows the active thread, reflects whether Codex is running, waiting for
43 input, or ready for review, and pairs that state with a short progress
44 prompt so you can glance at what changed without reopening the thread.
45
461/8
47
48CodexI found a tiny loose thread in settings. Want me to tug it?
49
50To create your own pet, install the `hatch-pet` skill:
51
52```text
53$skill-installer hatch-pet
54```
55
56Reload skills from the command menu. Press <kbd>Cmd+K</kbd> or <kbd>Ctrl+K</kbd>,
57choose **Force Reload Skills**, then ask the skill to create a pet:
58
59```text
60$hatch-pet create a new pet inspired by my recent projects
61```
62
33## Git63## Git
34 64
35Use Git settings to standardize branch naming and choose whether Codex uses force65Use 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 in73also 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.74`config.toml`. See the [Model Context Protocol docs](https://developers.openai.com/codex/mcp) for details.
45 75
76## Browser use
77
78Use these settings to install or enable the bundled Browser plugin and manage
79allowed and blocked websites. Codex asks before using a website unless you've
80allowed it. Removing a site from the blocked list lets Codex ask
81again before using it in the browser.
82
83See [In-app browser](https://developers.openai.com/codex/app/browser) for browser preview, comment, and
84browser use workflows.
85
86## Computer Use
87
88On macOS, check your Computer Use settings to review desktop-app access and related
89preferences after setup. To revoke system-level access, update Screen Recording
90or Accessibility permissions in macOS Privacy & Security settings. The feature
91isn't available in the EEA, the United Kingdom, or Switzerland at launch.
92
46## Personalization93## Personalization
47 94
48Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use95Choose **Friendly**, **Pragmatic**, or **None** as your default personality. Use
51You can also add your own custom instructions. Editing custom instructions updates your98You 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).99[personal instructions in `AGENTS.md`](https://developers.openai.com/codex/guides/agents-md).
53 100
101## Context-aware suggestions
102
103Use context-aware suggestions to surface follow-ups and tasks you may want to resume when you
104start or return to Codex.
105
106## Memories
107
108Enable Memories, where available, to let Codex carry useful context from past
109threads into future work. See [Memories](https://developers.openai.com/codex/memories) for setup, storage,
110and per-thread controls.
111
54## Archived threads112## Archived threads
55 113
56The **Archived threads** section lists archived chats with dates and project114The **Archived threads** section lists archived chats with dates and project