OpenAI - Codex Docs Changes 2026-05-05 23:00 UTC → 2026-05-07 17:08 UTC

49 49 

50## Start a computer use task50## Start a computer use task

51 51 

52Mention `@Computer Use` or `@AppName` in your prompt, or ask Codex to use52Mention `@Computer` or `@AppName` in your prompt, or ask Codex to use

53computer use. Describe the exact app, window, or flow Codex should operate.53computer use. Describe the exact app, window, or flow Codex should operate.

54 54 

55```text55```text

42| [`/model`](#set-the-active-model-with-model) | Choose the active model (and reasoning effort, when available). | Switch between general-purpose models (`gpt-4.1-mini`) and deeper reasoning models before running a task. |42| [`/model`](#set-the-active-model-with-model) | Choose the active model (and reasoning effort, when available). | Switch between general-purpose models (`gpt-4.1-mini`) and deeper reasoning models before running a task. |

43| [`/fast`](#toggle-fast-mode-with-fast) | Toggle Fast mode for supported models. | Turn Fast mode on or off, or check whether the current thread is using it. |43| [`/fast`](#toggle-fast-mode-with-fast) | Toggle Fast mode for supported models. | Turn Fast mode on or off, or check whether the current thread is using it. |

44| [`/plan`](#switch-to-plan-mode-with-plan) | Switch to plan mode and optionally send a prompt. | Ask Codex to propose an execution plan before implementation work starts. |44| [`/plan`](#switch-to-plan-mode-with-plan) | Switch to plan mode and optionally send a prompt. | Ask Codex to propose an execution plan before implementation work starts. |

45| [`/goal`](#set-or-view-an-experimental-task-goal-with-goal) | Set or view an experimental goal for a long-running task. | Give Codex a persistent target to track while a larger task runs. Requires `features.goals`. |

45| [`/personality`](#set-a-communication-style-with-personality) | Choose a communication style for responses. | Make Codex more concise, more explanatory, or more collaborative without changing your instructions. |46| [`/personality`](#set-a-communication-style-with-personality) | Choose a communication style for responses. | Make Codex more concise, more explanatory, or more collaborative without changing your instructions. |

46| [`/ps`](#check-background-terminals-with-ps) | Show experimental background terminals and their recent output. | Check long-running commands without leaving the main transcript. |47| [`/ps`](#check-background-terminals-with-ps) | Show experimental background terminals and their recent output. | Check long-running commands without leaving the main transcript. |

47| [`/stop`](#stop-background-terminals-with-stop) | Stop all background terminals. | Cancel background terminal work started by the current session. |48| [`/stop`](#stop-background-terminals-with-stop) | Stop all background terminals. | Cancel background terminal work started by the current session. |

108 109 

109While a task is already running, `/plan` is temporarily unavailable.110While a task is already running, `/plan` is temporarily unavailable.

110 111 

112### Set an experimental goal with `/goal`

113 

114`/goal` is experimental and only available when `features.goals` is enabled. To enable it, open `/experimental` or add `goals = true` under `[features]` in `config.toml`.

115 

1161. Type `/goal <objective>` to set the goal, for example `/goal Finish the migration and keep tests green`.

1172. Type `/goal` to view the current goal.

1183. Use `/goal pause`, `/goal resume`, or `/goal clear` to pause, resume, or remove it.

119 

120Expected: Codex keeps the goal attached to the active thread while work continues.

121 

111### Toggle experimental features with `/experimental`122### Toggle experimental features with `/experimental`

112 123 

1131. Type `/experimental` and press Enter.1241. Type `/experimental` and press Enter.

9starterPrompt:9starterPrompt:

10 title: Finish One Task From a Message Thread10 title: Finish One Task From a Message Thread

11 body: >-11 body: >-

12 @Computer Use Look at my messages from [person].12 @Computer Look at my messages from [person].

13 13 

14 14 

15 Then:15 Then:

45 45 

46For example:46For example:

47 47 

48- `@Computer Use Look at my messages from [person]. Check my availability, find 2 dinner options in Hayes Valley, and draft a reply in the same thread. Check in with me before completing booking.`48- `@Computer Look at my messages from [person]. Check my availability, find 2 dinner options in Hayes Valley, and draft a reply in the same thread. Check in with me before completing booking.`

49 49 

50## Practical tips50## Practical tips

51 51 

10starterPrompt:10starterPrompt:

11 title: Run a Structured QA Pass11 title: Run a Structured QA Pass

12 body: |-12 body: |-

13 @Computer Use Test my app in [environment].13 @Computer Test my app in [environment].

14 14 

15 Test these flows:15 Test these flows:

16 - [hero use case 1]16 - [hero use case 1]

46 46 

47You can keep this broad:47You can keep this broad:

48 48 

49- `@Computer Use Test my app. Find any major issues and give me a report.`49- `@Computer Test my app. Find any major issues and give me a report.`

50 50 

51Or make it more explicit:51Or make it more explicit:

52 52 

53- `@Computer Use Test my app in staging. Cover signup, invite a teammate, and upgrade billing. Log every bug with repro steps, expected result, actual result, and severity.`53- `@Computer Test my app in staging. Cover signup, invite a teammate, and upgrade billing. Log every bug with repro steps, expected result, actual result, and severity.`

54 54 

55If you already maintain a test-plan file in the repo, attach it to the thread or point Codex at it so the QA pass follows your existing flows.55If you already maintain a test-plan file in the repo, attach it to the thread or point Codex at it so the QA pass follows your existing flows.

56 56 

10starterPrompt:10starterPrompt:

11 title: Hand Off One Computer Task11 title: Hand Off One Computer Task

12 body: >-12 body: >-

13 @Computer Use [do the task you want completed across your Mac]13 @Computer [do the task you want completed across your Mac]

14 14 

15 15 

16 For example:16 For example:

40## How to use40## How to use

41 41 

421. Install the [Computer Use plugin](https://developers.openai.com/codex/app/computer-use).421. Install the [Computer Use plugin](https://developers.openai.com/codex/app/computer-use).

432. Start your request with `@Computer Use`, or mention a specific app such as `@Slack` or `@Messages`.432. Start your request with `@Computer`, or mention a specific app such as `@Slack` or `@Messages`.

443. Describe the task and the outcome you want.443. Describe the task and the outcome you want.

454. Approve access when Codex needs it, then let it continue the task in the background.454. Approve access when Codex needs it, then let it continue the task in the background.

46 46 

48 48 

49For example:49For example:

50 50 

51- `@Computer Use Play some music to help me focus.`51- `@Computer Play some music to help me focus.`

52- `@Computer Use Help me add my interview notes from Notes to Ashby.`52- `@Computer Help me add my interview notes from Notes to Ashby.`

53- `@Computer Use Go through my Slack and add reminders for everything I need to do by end of day.`53- `@Computer Go through my Slack and add reminders for everything I need to do by end of day.`

54 54 

55## Practical tips55## Practical tips

56 56