[Codex App] Browser preview/PiP repeatedly opens over chat despite visible: false
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
Environment
- Codex desktop app on macOS.
- Installed unified-computer-use/browser plugin version:
26.901.51231. - Exact desktop app version has not been independently confirmed.
What issue are you seeing?
During browser automation, a floating browser preview / Picture-in-Picture window repeatedly appears on top of the chat. It obscures the conversation and requires manual dismissal each time.
Global custom instructions and project instructions explicitly require browser work to remain in the background, prohibit enabling browser visibility or showing preview cards, and request ordinary clickable links for handoffs. These instructions were confirmed present. Recent browser creation calls also explicitly supplied hidden mode:
await cua.createBrowserTab("iab", url, { visible: false });
The installed tool documentation describes visible: false as keeping the browser hidden. The unwanted floating preview still occurs in the user's workflow. The exact operation that triggers the overlay after tab creation has not yet been isolated; this report does not claim a confirmed root cause or an independently reproduced minimal test.
Steps / observed workflow
- Use Codex desktop with Browser and Computer Use enabled.
- Instruct the agent to keep all browser activity in the background.
- Have it perform browser work with in-app tabs created using
visible: false. - Observe floating browser previews appearing over chat during the workflow.
- Dismiss the preview manually; it appears again during subsequent browser activity.
Expected behavior
Hidden browser automation should remain hidden throughout the operation and after control returns to chat. Browser tool activity should not automatically show a floating preview when visibility is explicitly false.
Impact
The repeated overlay interrupts reading and writing in the chat and requires repeated manual cleanup. Adding stronger custom instructions has not resolved it.
Related request
Related to #32451, which requests a persistent opt-out for automatic PiP. This report adds the specific hidden-mode concern involving visible: false. A persistent setting such as “Never automatically show browser previews,” while retaining Browser and Computer Use capabilities, would also address the user-control problem.
No private project information, customer data, screenshots, credentials, or session logs are included.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Codex desktop app's Browser and Computer Use workflow, using cua.createBrowserTab with visible: false. Reproduce the overlay and isolate which browser operation after tab creation triggers it. Done means hidden browser activity remains hidden throughout the operation and after control returns to chat.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- macos
- Domain
- desktop
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100