app/features.md +91 −3
31 31
32You can also combine skills with [automations](https://developers.openai.com/codex/app/automations) to perform routine tasks32You can also combine skills with [automations](https://developers.openai.com/codex/app/automations) to perform routine tasks
33such as evaluating errors in your telemetry and submitting fixes or creating reports on recent33such as evaluating errors in your telemetry and submitting fixes or creating reports on recent
3434codebase changes.codebase changes. For ongoing work that should stay in one thread, use a
35[thread automation](https://developers.openai.com/codex/app/automations#thread-automations).
35 36
3637
37 38
130 131
131132
132 133
134## In-app browser
135
136Use the [in-app browser](https://developers.openai.com/codex/app/browser) to preview, review, and comment on
137local development servers, file-backed previews, and public pages that don't
138require sign-in while you iterate on a web app.
139
140The in-app browser doesn't support authentication flows, signed-in pages, your
141regular browser profile, cookies, extensions, or existing tabs.
142
143Use browser comments to mark specific elements or areas on a page, then ask
144Codex to address that feedback.
145
146
147
148## Computer use
149
150[Computer use](https://developers.openai.com/codex/app/computer-use) helps Codex operate a macOS app by
151seeing, clicking, and typing. This is useful for testing desktop apps, checking
152browser or simulator flows, working with data sources that aren't available as
153plugins, changing app settings, and reproducing GUI-only bugs.
154
155Because computer use can affect app and system state outside your project
156workspace, keep tasks narrow and review permission prompts before continuing.
157
158The feature isn't available in the European Economic Area, the United Kingdom, or
159Switzerland at launch.
160
161
162
163## Work with non-code artifacts
164
165When a task produces non-code artifacts, the sidebar can preview PDF files,
166spreadsheets, documents, and presentations. Give Codex the source data, expected
167file type, structure, and review criteria you care about.
168
169For spreadsheets and presentations, describe the sheets, columns, charts, slide
170sections, and checks that matter. Ask Codex to explain where it saved the output
171and how it checked the result.
172
173Use the task sidebar to follow what Codex is doing while a thread runs. It can
174surface the agent's plan, sources, generated artifacts, and task summary so you
175can steer the work, inspect generated files, and decide what needs another pass.
176
177
178
133---179---
134 180
135## Sync with the IDE extension181## Sync with the IDE extension
146If you're unsure whether the app includes context, toggle it off and ask the192If you're unsure whether the app includes context, toggle it off and ask the
147same question again to compare results.193same question again to compare results.
148 194
195## Thread automations
196
197Automations can also attach to a single thread. These thread automations are
198recurring wake-up calls that preserve the thread's context so Codex can check
199on long-running work, poll a source for new information, or continue a follow-up
200loop. Use them for heartbeat-style automations that should keep returning to the
201same conversation on a schedule.
202
203Use a thread automation when the next run depends on the current conversation.
204Use a standalone or project [automation](https://developers.openai.com/codex/app/automations) when you want
205Codex to start a fresh recurring task for one or more projects.
206
149## Approvals and sandboxing207## Approvals and sandboxing
150 208
151Your approval and sandbox settings constrain Codex actions.209Your approval and sandbox settings constrain Codex actions.
164opening separate projects or using worktrees rather than asking Codex to roam222opening separate projects or using worktrees rather than asking Codex to roam
165outside the project root.223outside the project root.
166 224
167225For a high-level overview, see [Sandboxing](https://developers.openai.com/codex/concepts/sandboxing). ForFor a high-level overview, see [sandboxing](https://developers.openai.com/codex/concepts/sandboxing). For
168configuration details, see the226configuration details, see the
169[agent approvals & security documentation](https://developers.openai.com/codex/agent-approvals-security).227[agent approvals & security documentation](https://developers.openai.com/codex/agent-approvals-security).
170 228
177 235
178## Web search236## Web search
179 237
180238Codex ships with a first-party web search tool. For local tasks in the Codex IDE Extension, CodexCodex ships with a first-party web search tool. For local tasks in the Codex app, Codex
181enables web search by default and serves results from a web search cache. If you configure your239enables web search by default and serves results from a web search cache. If you configure your
182sandbox for [full access](https://developers.openai.com/codex/agent-approvals-security), web search defaults to live results. See240sandbox for [full access](https://developers.openai.com/codex/agent-approvals-security), web search defaults to live results. See
183[Config basics](https://developers.openai.com/codex/config-basic) to disable web search or switch to live results that fetch the241[Config basics](https://developers.openai.com/codex/config-basic) to disable web search or switch to live results that fetch the
184most recent data.242most recent data.
185 243
244## Image generation
245
246Ask Codex to generate or edit images directly in a thread. This is useful for UI assets, banners, backgrounds, illustrations, sprite sheets, and placeholders you want to create alongside code. Add a reference image when you want Codex to transform or extend an existing asset.
247
248You can ask in natural language or explicitly invoke the image generation skill by including `$imagegen` in your prompt.
249
250Built-in image generation uses `gpt-image-1.5`, counts toward your general Codex usage limits, and uses included limits 3-5x faster on average than similar turns without image generation, depending on image quality and size. For details, see [Pricing](https://developers.openai.com/codex/pricing#image-generation-usage-limits). For prompting tips and model details, see the [image generation guide](https://developers.openai.com/api/docs/guides/image-generation).
251
252For larger batches of image generation, set `OPENAI_API_KEY` in your environment variables and ask Codex to generate images through the API so API pricing applies instead.
253
186## Image input254## Image input
187 255
188You can drag and drop images into the prompt composer to include them as context. Hold down `Shift`256You can drag and drop images into the prompt composer to include them as context. Hold down `Shift`
191You can also ask Codex to view images on your system. By giving Codex tools to take screenshots of259You can also ask Codex to view images on your system. By giving Codex tools to take screenshots of
192the app you are working on, Codex can verify the work it's doing.260the app you are working on, Codex can verify the work it's doing.
193 261
262## Chats
263
264Chats are threads you can start when the task doesn't need a specific project
265folder or Git repository. Use them for research, triage, planning,
266plugin-heavy workflows, and other conversations where Codex should use connected
267tools instead of editing a codebase.
268
269Chats use a Codex-managed `threads` directory under your Codex home as their
270working location. By default, that location is `~/.codex/threads`.
271
272## Memories
273
274[Memories](https://developers.openai.com/codex/memories), where available, let Codex carry useful context
275from past tasks into future threads. They're most useful for stable preferences,
276project conventions, recurring work patterns, and known pitfalls that would
277otherwise need to repeat.
278
194## Notifications279## Notifications
195 280
196By default, the Codex app sends notifications when a task completes or needs approval while the app281By default, the Codex app sends notifications when a task completes or needs approval while the app
208 293
209- [Settings](https://developers.openai.com/codex/app/settings)294- [Settings](https://developers.openai.com/codex/app/settings)
210- [Automations](https://developers.openai.com/codex/app/automations)295- [Automations](https://developers.openai.com/codex/app/automations)
296- [In-app browser](https://developers.openai.com/codex/app/browser)
297- [Computer use](https://developers.openai.com/codex/app/computer-use)
298- [Review pane](https://developers.openai.com/codex/app/review)
211- [Local environments](https://developers.openai.com/codex/app/local-environments)299- [Local environments](https://developers.openai.com/codex/app/local-environments)
212- [Worktrees](https://developers.openai.com/codex/app/worktrees)300- [Worktrees](https://developers.openai.com/codex/app/worktrees)