Repository navigation
Codex Desktop Windows Browser Use blocks file:// file-backed previews with URL policy #24847
Description
Summary
Codex Desktop for Windows Browser Use rejects file:// file-backed previews before navigation, even though the Codex in-app browser documentation says file-backed previews are supported.
The rejection happens as a Browser Use URL policy error, not as a file-not-found error.
Environment
- Platform: Microsoft Windows NT 10.0.26200.0 x64
- Codex Desktop package:
OpenAI.Codex_26.519.11010.0_x64__2p2nqsd0c76g0 - Codex app version:
26.519.11010.0 - Browser plugin:
browser@openai-bundledversion26.519.81530 - Workspace trust level: trusted
- Browser plugin enabled: yes
- Windows sandbox setting:
elevated
Expected behavior
Browser Use should be able to open and inspect local file-backed previews in the in-app browser, or at least ask for/offer the relevant permission.
The official docs describe the in-app browser and Browser Use as appropriate for local development servers and file-backed previews:
https://developers.openai.com/codex/app/browser
Actual behavior
Attempting to navigate the in-app browser to a local file:// HTML page is rejected before navigation with:
Browser Use rejected this action due to browser security policy. Reason: Browser Use cannot visit the requested page because its URL is blocked by the Browser Use URL policy. The agent must not attempt to achieve the same outcome via workaround, indirect execution, raw CDP or browser commands, alternate browser surfaces, or policy circumvention. Proceed only with a materially safer alternative that does not require this blocked browser action; if none exists, stop and request user input.
This occurs both for the real preview file and for a minimal test file created inside the current trusted workspace.
Reproduction steps
- Start Codex Desktop for Windows.
- Open the in-app browser panel. It starts at
about:blank. - Use Browser Use with the
iabbackend. - Create a minimal HTML file inside the trusted current workspace.
- Ask Browser Use to open a local file URL such as:
file:///C:/Users/itosu/Documents/Codex/2026-05-28/in-app-browser-2/browser-file-policy-test.html
- Browser Use rejects the navigation with the URL policy error above.
Additional diagnostics
- The original target file exists locally.
- The same URL policy rejection also occurs for a
data:text/html,...diagnostic page. - Browser runtime initialization works after running Codex Desktop as administrator.
agent.browsers.list()can see the Codex in-app browser and itsabout:blanktab.winget upgrade --id 9PLM9XGG6VKS --source msstorereports no available update.- Earlier non-admin runs showed Windows sandbox privilege errors, but after admin launch the remaining blocker is specifically the Browser Use URL policy.
Related issues
This appears related to recent Windows Browser Use / in-app browser permission-policy issues, but the exact symptom is file:// / file-backed preview blocking:
- Codex Desktop Windows: Chrome plugin connects but navigation blocked because thread networkAccess persists as false #21955: browser navigation blocked by security policy /
networkAccess: false - Browser Use fails on Windows Codex Desktop: failed to start codex app-server (os error 3) #20206: Browser Use detects IAB tab but browser operations fail on Windows
- Browser Use disappeared from Codex App despite enabled feature flags #21440: Browser Use disappeared despite feature flags
- Browser Use IAB backend fails to connect on Windows #20846: Browser Use IAB backend fails to connect on Windows
Impact
This breaks the documented workflow for previewing local generated HTML files and file-backed previews inside Codex. The workaround is to serve files through localhost, but that is not the same as the documented file-backed preview behavior.
Activity
swartzrock commentedon Jun 12, 2026
also reproduces on macOS in Version
26.608.12217, big blocker in productivity. This feature works find in Claude.app, which can view the html files generated in a chat.TomasHubelbauer commentedon Jun 29, 2026
Very weird behavior, there is no point in running a server for any old random HTML report.
MieTakahashi2 commentedon Sep 5, 2026
Also reproducing on macOS with Codex Desktop 26.901.41123 (build 7942), checked on 2026-09-05.
An existing, user-authorized local HTML file inside the project workspace is rejected before navigation with a Browser Use URL policy error. Opening a public HTTPS documentation page and capturing its screenshot succeeds through the official in-app browser tools.
Browser is enabled and website approval is set to Always allow. Restarting the app and retrying with Full Access enabled did not resolve the rejection.
This blocks visual verification of generated HTML. The rejection also explicitly instructs the agent not to use workarounds or alternate browser surfaces, so the agent stops rather than trying the localhost approach mentioned in the issue.
Could maintainers clarify the supported remediation for file-backed previews, and whether serving the same workspace preview over localhost is an intended, permitted alternative despite that rejection message?
7ammad commentedon Sep 8, 2026
Confirmed on Windows with browser plugin 26.901.51231. The plugin description explicitly includes file:// targets, while browser-service.mjs accepts only about:blank, http:, and https:. Navigating to a local workspace HTML report produces navigation_url_policy_blocked. Please provide supported access to authorized workspace HTML previews and align the documented capabilities with runtime behavior.
1wgrumph commentedon Sep 8, 2026
Origin
OpenAI bundled browser integration; not project-defined policy.
Harness / version
Codex CLI 0.153.2; browser plugin 26.831.20005; Linux.
What
Opening a local HTML file through the browser tool produces
navigation_url_policy_blocked, although the plugin manifest explicitly advertisesfile://support.Current evidence
The failure occurred during an explicit user request. Installed runtime inspection found that
nv()permits only HTTP, HTTPS andabout:blank;G5()enforces that check. The rejection also prohibits alternate execution paths. No workaround was attempted.This confirms an advertised-capability/runtime mismatch, without establishing whether local-file support or the documentation should change.
Expected
Advertised capabilities and enforced URL policy agree. Errors distinguish unsupported functionality from user-configured restrictions.
Acceptance
Add regression coverage for local-file navigation and align the manifest, implementation and error guidance with the intended behavior.
thapro73-cpu commentedon Sep 9, 2026
Also reproduced on Windows on 2026-09-10 with Codex Desktop package
OpenAI.Codex_26.901.6511.0_x64__2p2nqsd0c76g0.An existing, user-authorized HTML file in the project workspace displays normally when opened directly by the user in the in-app browser. However,
cua.createBrowserTab("iab", "file:///.../leaderboard.html", {visible:true})is rejected before navigation withnavigation_url_policy_blocked. The path above is a redacted placeholder, not a real user path.Read-only inspection of the installed URL validator found that it accepts only
about:blank,http:andhttps:, separately from site-approval settings. This is a URL-scheme rejection, not a missing or broken HTML file. No policy bypass or security changes were attempted during this diagnosis.Could maintainers clarify the officially supported way to automatically display user-authorized workspace HTML, and whether a fix or supported permission mechanism is planned? If this restriction is intentional, please align the documented capabilities and error guidance so users are not directed to unrelated Windows security or broader access settings.
No project data, screenshots, credentials, full local paths, or session logs are attached.
NovaSabre commentedon Sep 10, 2026
Still reproducible on Windows on September 10, 2026, with Codex Desktop package version
26.903.9818.0(verified usingGet-AppxPackage).In an active local project, Codex can read and edit workspace files, but the bundled Browser Use tool rejects opening an existing, user-authorized SVG reference sheet via
file://before navigation. The selected backend was the Codex in-app browser. The task had unrestricted filesystem access and network access enabled.Redacted reproduction:
file:///C:/example-project/docs/reference-sheet.svg(placeholder path only).The rejection also explicitly instructs the agent not to achieve the same outcome through workarounds or alternate browser surfaces. This leaves the agent unable to perform the visual verification required before implementing the planned icon change. No bypass or security-setting changes were attempted.
Could maintainers confirm whether this is a known unresolved bug or an intentional restriction? What is the officially supported way to inspect user-authorized local SVG/HTML previews, and is a fix planned? In particular, is serving a preview through localhost a supported alternative despite the rejection message's prohibition on workarounds?
No project names, real local paths, credentials, account identifiers, screenshots, or session logs are included. This comment was prepared and posted by Codex with the account owner's explicit authorization.
Bagh13nrv commentedon Sep 21, 2026
Additional reproduction on Windows, observed on September 21, 2026.
Verified behavior
getTab, or opening its URL withcreateBrowserTab, is rejected before inspection with:The browser URL policy blocks this action.file:///URL as an invalid origin. We understand that the documented origin rules cover HTTP/HTTPS; this does not provide an authorization path for the existing local preview.Environment and scope
26.915.3509.0.26.915.31945. This is a plugin version, not a claim about the current app version.Recovery guidance needing clarification
The tool's rejection explicitly prohibits achieving the same outcome through workarounds, indirect execution, raw CDP, or alternate browser surfaces. The Help Center AI suggested serving the files on localhost, but could not reconcile that suggestion with the prohibition or confirm a tracked support case. We have not applied that workaround after the denial, and the chatbot's suggestion is not treated as permission to bypass policy.
Could maintainers clarify whether agent inspection of authorized local file-backed previews is supported, and provide the intended recovery/approval path or corrective release? In particular, please align the refusal guidance with any officially supported alternative. Related recovery concern: #44881; related visible-preview/blocked-inspection report: #36552.
This report was posted by Codex with the account owner's explicit authorization. No course contents, student data, personal filesystem paths, account/session identifiers, screenshots, credentials, or full logs are included. We have not established whether the underlying cause is an intentional scheme restriction or a regression.
diegoscl commentedon Sep 27, 2026
Additional reproduction on macOS, observed September 27, 2026.
Verified behavior
file://URL.iabbrowser and the existing tab.The refusal also prohibited workarounds, indirect execution, raw CDP, and alternate browser surfaces. We did not attempt another route after that refusal.
Environment and impact
browser@openai-bundledclient bundle26.924.22138.Could maintainers clarify whether Browser Use is intended to inspect an existing, visible
file://tab on macOS? If file-backed previews are unsupported, what is the approved path for agent-assisted visual verification when the refusal explicitly forbids alternate routes?speedraj108 commentedon Oct 9, 2026
Additional Windows observation, verified on 2026-10-09, posted with the account owner's explicit authorization.
Confirmed behavior
An existing, user-authorized local HTML design preview opens visibly for the user. The original recorded Browser Use result for
cua.createBrowserTab("iab", "file:///…/preview.html", {visible:true})rejects the request before inspection:The same tool result explicitly prohibits workarounds, indirect execution, raw CDP/browser commands, and alternate browser surfaces. This was verified from the original tool return, not merely an assistant's later explanation. The placeholder URL above is redacted.
Version evidence
OpenAI.Codex, version26.1002.7124.0.installedVersion: 26.1002.52244, build13536, release channelprod.Requested actionable recovery
The official Browser guide describes local development-server previews and browser-assisted visual review. The current refusal leaves no clear supported recovery for this authorized preview.
Could maintainers provide:
file:navigation and a denied origin/resource.The practical impact is interrupted visual iteration and repeated manual screenshot work. We are not requesting removal of security checks or claiming that all Chromium/HTTP workflows are prohibited. No private HTML, images, screenshots, filesystem paths, credentials, conversation history, or full logs are included.