use-cases/use-your-computer-with-codex.md +75 −0 added
1---
2name: Use your computer with Codex
3tagline: Let Codex click, type, and navigate apps on your Mac.
4summary: Use Computer Use to hand off multi-step tasks across Mac apps, windows,
5 and files.
6bestFor:
7 - Tasks that move across apps, windows, browser sessions, or local files on
8 your Mac
9 - Work you want to hand off and let Codex continue in the background
10starterPrompt:
11 title: Hand Off One Computer Task
12 body: >-
13 @Computer [do the task you want completed across your Mac]
14
15
16 For example:
17
18 - Play some music to help me focus.
19
20 - Help me add my interview notes from Notes to Ashby.
21
22 - Look through my Messages app for the trip ideas Brooke sent me this week,
23 add the best options to a new note called "Yosemite ideas", and draft a
24 reply back to her.
25relatedLinks:
26 - label: Computer Use
27 url: /codex/app/computer-use
28 - label: Plugins
29 url: /codex/plugins
30 - label: Customize Codex
31 url: /codex/concepts/customization
32---
33
34## Introduction
35
36You can let Codex operate an app the same way you would: by clicking, seeing, and typing. [Computer Use](https://developers.openai.com/codex/app/computer-use) is useful when the task lives inside a normal app UI, even if that app does not have a dedicated plugin.
37
38This works especially well for tasks that jump between apps or windows, such as collecting notes, updating a system of record, copying details from one place to another, or drafting a reply after checking context in a few different apps.
39
40## How to use
41
421. Install the [Computer Use plugin](https://developers.openai.com/codex/app/computer-use).
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.
454. Approve access when Codex needs it, then let it continue the task in the background.
46
47If you mention a specific app and a plugin exists for that app, Codex may prefer the plugin over Computer Use. That is usually what you want. If no plugin exists, Codex can fall back to Computer Use and operate the app directly.
48
49For example:
50
51- `@Computer Play some music to help me focus.`
52- `@Computer Help me add my interview notes from Notes to Ashby.`
53- `@Computer Go through my Slack and add reminders for everything I need to do by end of day.`
54
55## Practical tips
56
57### Choose the browser Codex should use
58
59Computer Use takes control of the app it is operating. If you want to keep working in one browser while Codex browses in another, tell it which browser to use. You can also set a default in [customization](https://developers.openai.com/codex/concepts/customization), for example: "When using Computer Use for web browsing tasks, default to Chrome instead of Safari."
60
61### Avoid parallel runs in the same app
62
63Do not run two Computer Use tasks against the same app at the same time. That makes it much harder for Codex to keep stable context about the current window and state.
64
65### Stay signed in
66
67For smoother runs, make sure you are already signed in to the apps and services you want Codex to use. If your Mac locks while Computer Use is running, the activity will stop.
68
69## Good follow-ups
70
71Once the task finishes, keep the same thread open if you want Codex to summarize what it changed, double-check the result, or turn the workflow into a more repeatable pattern through [customization](https://developers.openai.com/codex/concepts/customization).
72
73## Suggested prompt
74
75**Hand Off One Computer Task**