app/browser.md +34 −2
6 6
7Use it for local development servers, file-backed previews, and public pages7Use it for local development servers, file-backed previews, and public pages
8that don't require sign-in. For anything that depends on login state or browser8that don't require sign-in. For anything that depends on login state or browser
99extensions, use your regular browser.extensions, use your regular browser or the
10[Codex Chrome extension](https://developers.openai.com/codex/app/chrome-extension).
10 11
11Open the in-app browser from the toolbar, by clicking a URL, by navigating12Open the in-app browser from the toolbar, by clicking a URL, by navigating
12manually in the browser, or by pressing <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd>13manually in the browser, or by pressing <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>B</kbd>
18 19
19Treat page content as untrusted context. Don't paste secrets into browser flows.20Treat page content as untrusted context. Don't paste secrets into browser flows.
20 21
2122<CodexScreenshot
23 alt="Codex app showing a browser comment on a local web app preview"
24 lightSrc="/images/codex/app/in-app-browser-light.webp"
25 darkSrc="/images/codex/app/in-app-browser-dark.webp"
26 maxHeight="420px"
27 variant="no-wallpaper"
28/>
29
30## Browser use
31
32Browser use lets Codex operate the in-app browser directly. Use it for local
33development servers and file-backed previews when Codex needs to click, type,
34inspect rendered state, take screenshots, or verify a fix in the page.
35
36To use it, install and enable the Browser plugin. Then ask Codex to use the
37browser in your task, or reference it directly with `@Browser`. The app keeps
38browser use inside the in-app browser and lets you manage allowed and blocked
39websites from settings.
40
41Example:
42
43```text
44Use the browser to open http://localhost:3000/settings, reproduce the layout
45bug, and fix only the overflowing controls.
46```
47
48Codex asks before using a website unless you've allowed it. Removing a site from
49the allowed list means Codex asks again before using it; removing a site from the
50blocked list means Codex can ask again instead of treating it as blocked.
51
52For signed-in websites in Chrome, see
53[Codex Chrome extension](https://developers.openai.com/codex/app/chrome-extension).
22 54
23## Preview a page55## Preview a page
24 56