Mac app shows persistent blurred/translucent overlay below composer
What version of the Codex App are you using (From “About Codex” dialog)?
0.122.0-alpha.1
What subscription do you have?
Plus
What platform is your computer?
Darwin 24.0.0 x86_64 i386
What issue are you seeing?
Summary
The Codex Mac app renders a large blurred/translucent overlay below the composer/focus box that obscures the main content area and makes the app effectively unusable.
This is happening on an Intel Mac running macOS Sequoia 15.0.1.
Environment
- Device: Intel Mac
- OS: macOS Sequoia 15.0.1
- App / bundled version:
codex-cli 0.122.0-alpha.1
Actual behavior
A large blurred/translucent block appears below the composer and stays there. It covers the main window content area and does not go away.
Expected behavior
The area below the composer should render normal app content, not a persistent blur/material overlay.
Reproduction
I do not have a precise trigger yet.
Current observed behavior:
- Open Codex for Mac
- Main window loads
- A persistent blurred/translucent overlay is visible below the composer
- Overlay remains and blocks normal use
What I already tried
None of these fixed it:
- Quit / relaunch
- Restart Mac
- Reinstall app
- Reset Codex config
- Toggle app UI panes / layout
- Reset app appearance/theme
- Enable macOS "Reduce transparency"
- Clear app plist / caches / saved state
Notes
This looks like a rendering/compositor issue rather than normal UI state.
I can attach a screenshot showing the blur overlay if helpful.
<img width="3118" height="2028" alt="Image" src="https://github.com/user-attachments/assets/893397fe-bcf7-4abc-88f2-2eb9cded9fcf" />
What steps can reproduce the bug?
Steps to reproduce
- Use an Intel Mac running macOS Sequoia 15.0.1
- Install and open the Codex Mac app
- Sign in and open the main app window / a new thread
- Wait for the UI to finish rendering
- Observe that a large blurred/translucent overlay appears below the composer and obscures the main content area
Actual behavior
A persistent blurred/translucent block is rendered below the composer. It stays in place and makes the main window unusable.
Expected behavior
The area below the composer should render normal app content, with no persistent blur/material overlay.
Reproducibility
Happens consistently on launch for me.
Code snippet
Not applicable. This appears to be a desktop UI rendering/compositor bug, not an SDK/API/code-execution issue.
Session / token / context info
- Session ID: N/A / unavailable
- Token limit usage: N/A
- Context window usage: N/A
This bug appears before any meaningful model interaction, so it does not seem tied to prompt content, token usage, or context size.
Environment
- Device: Intel Mac
- OS: macOS Sequoia 15.0.1
- App bundled version:
codex-cli 0.122.0-alpha.1
Extra notes
I already tested quit/relaunch, restart, reinstall, config reset, cache/saved-state reset, UI/layout toggles, theme reset, and macOS transparency changes. None fixed it.
Screenshot attached.
What is the expected behavior?
The area below the composer should render normal app content, not a persistent blur/material overlay.
Additional information
_No response_
36 Comments
Same issue with my Macbook Pro 2019 i9 32GB RAM
Any fixes
Super slow here as well. Sticking to the CLI until this is resolved.
Seems like it occurs everywhere there's an input box.
<img width="2928" height="2462" alt="Image" src="https://github.com/user-attachments/assets/a7422a2f-2c99-4561-901f-030c4ec1f04a" />
I also notice when i make the screen small the overlay gone. but the dead slow behaviour still there. looks like its something related to hardware acceleration + electron combo.
I can confirm what looks like the same bug on another Intel Mac.
Environment:
26.415.30602(build1773)15.7.3(build24G419)MacBookPro16,1/ IntelCore i9-9880H/x86_64What I see:
Extra signal:
open -na "Codex" --args --disable-gpudid not produce a usable app window here, so that was not a practical workaround in my case.This seems consistent with the reports above from Intel Macs and may help narrow it to the desktop app rendering path on Intel + macOS 15.
I’m seeing what looks like the same underlying desktop rendering bug on another Intel Mac setup.
Environment
com.openai.codex26.415.21839176315.7.5 (24G624)MacBookPro15,4What I see
New chatrenders with oversized dark/black blocks below the composerPluginsalso renders incorrectly with large dark/black content regions and incomplete layoutWhat I tried
26.415.21839is the newest available version--disable-gpu--disable-gpu-compositing--disable-features=Metal,UseSkiaRendererThis looks very similar to the overlay/compositor/rendering problem described here, but on
26.415.21839and with bothNew chatandPluginsaffected.I also opened an OpenAI support case and it has already been escalated as a Codex desktop rendering bug.
Very, very slow.
Any update regarding the issue?
When we can expect to get this resolved, not being able to use codex app right now.
same issue with all search bars
mac info: Darwin 25.4.0 x86_64 i386
codex version: 26.417.41555 (1858)
same issue
Macbook pro 13-inch, 2020, Two Thunderbolt 3 ports
codex version : 26.417.41555
MacBook Pro
15-inch, 2019
Processor
2.6 GHz 6-Core Intel Core i7
Graphics
Intel UHD Graphics 630
1536 MB
Memory
16 GB 2400 MHz DDR4
macOS
Sequoia 15.7.5
Codex
Version 26.422.20832 (2025)
<img width="1679" height="1044" alt="Image" src="https://github.com/user-attachments/assets/004b45d1-fde7-428b-bb71-af5d22383390" />
<img width="1410" height="956" alt="Image" src="https://github.com/user-attachments/assets/c605f264-c99e-4780-a54a-fb8ed4b6485f" />
Symptoms:
In the Plugins and Skills pages, part of the UI gets covered by a blurred white overlay.
In the chat window, similar blurred white regions can appear near the lower area.
Clicking the affected area can still open the underlying popup/popover content correctly.
After closing or returning, the blurred overlay remains visible.
If I narrow the window below a certain width, the issue disappears.
If I widen the window again past that width, the issue returns.
Same issue.
Temporary workaround for the Intel Mac GUI rendering bug:
On my Intel Mac,
swiftshaderrenders correctly but is too slow to use. The first hardware-backed combo I found that rendered the brokenPluginspage correctly was:--disable-gpu-sandbox --use-angle=gl --disable-zero-copyI verified this by repeatedly relaunching the app and capturing the actual Codex window while switching to the broken
Pluginsview.What I tested:
--use-angle=metal: faster, but stale or incorrect repaints remained--use-angle=metal --disable-gpu-rasterization: still broken--use-angle=metal --disable-zero-copy: still broken--disable-gpu-sandbox --use-angle=swiftshader: visually correct, but very laggy--disable-gpu-sandbox --use-angle=gl: much better--disable-gpu-sandbox --use-angle=gl --disable-zero-copy: best fast workaround I foundI wrapped the app executable so every launch path uses:
--disable-gpu-sandbox --use-angle=gl --disable-zero-copyThis is only a workaround, not a real fix, but it made the Intel Mac GUI usable for me.
@dimillian-oai any chance we can get this looked at?
I am seeing what appears to be the same issue on an Intel Mac.
Environment:
26.422.30944(CFBundleVersion2080)41.2.0(from the running crashpad process annotation)13.7.8(22H730)22.6.0x86_64Intel(R) Core(TM) i7-7700HQ CPU @ 2.80GHzObserved behavior:
same issue
@tibo-openai Is there a rough timeline on when this might be addressed or prioritized?
On Codex Desktop for macOS Intel, the Plugins marketplace page is visually broken: plugin cards/content are partially covered by a large overlay/preview layer. Plugins are still clickable and plugin detail pages open correctly, so this looks like a rendering/layout layering issue rather than a plugin loading failure.
App: 26.422.30944 (2080)
Arch: x86_64 / Intel Mac
CLI: codex-cli 0.125.0
Attaching screenshots of the broken marketplace grid and a plugin detail page that opens successfully.
<img width="1680" height="1050" alt="Image" src="https://github.com/user-attachments/assets/88744bdf-7533-4bd9-af78-e7ca6ddd1a3a" />
<img width="1680" height="1050" alt="Image" src="https://github.com/user-attachments/assets/43dd510f-518b-4a65-b840-432cdc240269" />
solution / fix:
source: https://x.com/colins_space/status/2048193500190318631
https://github.com/DeanHH/IntelMacCodexClaudeAppWrapper
You can launch your app using this AppWrapper.
exact same issue
This doesn't work for Macbook Pro 13" 2019.
This works but it cause strange colors in the input area.
I can confirm this is still reproducible after reinstalling the Codex desktop app.
Environment
26.429.30905 (2345)15.7.5(24G624)24.6.0/x86_64MacBookPro15,2Intel(R) Core(TM) i5-8259U CPU @ 2.30GHzObserved behavior
Troubleshooting already tried
Cmd+0This looks like the same compositor/overlay issue described above, but it is still present in
26.429.30905 (2345).Here is my temporary solution until codex fix it:
Press "Cmd" + "-" several times until the overlay disappear.
This temporary solution of yours is better and simpler.
Claude Desktop and Codex also suffer from this issue; obscured areas appear
when resizing the window.
snowball @.***>于2026年5月2日 周六18:08写道:
exact same issue
I have the same issue; it's been there since I installed and launched the Codex app for the first time.
Environment
Workarounds Tried
一样的问题,下方有个模糊涂层。使用command+-快捷键缩放三次后会正常,但是字体太小几乎无法使用。
环境
<img width="1726" height="834" alt="Image" src="https://github.com/user-attachments/assets/49f14c9a-37cf-46d4-a31f-b78ce7469c05" />
After a few days of investigation on a 2017 MacBook Pro (Intel HD Graphics 630 + macOS 13), I narrowed this down to a specific CSS root cause and built a fix that doesn't need any command-line flags.
Root cause
The transparent / blurred / "overlay" artifacts all come from CSS
backdrop-filter: blur()rules in Codex's stylesheet. On Intel HD/UHD Graphics + macOS,backdrop-filterforces the Chromium compositor to capture the background through an IOSurface and reblend it. That IOSurface transfer silently fails on this driver+OS combo, leaving the element rendered as transparent (so you see the desktop behind the window) or as a stale buffer.This explains the existing workarounds in the thread:
Cmd + -works because zoom triggers re-layout, invalidating the broken layer--force_high_performance_gpuworks on dual-GPU MBPs because it bypasses the Intel driver entirelyFix
Full analysis + reproducible report: #23458
Repository with installer: https://github.com/Uncle-Gao/codex-gpu-fix
It wraps the Codex binary so that on launch:
--use-angle=metal --remote-debugging-port=9222* { backdrop-filter: none !important; -webkit-backdrop-filter: none !important; }document.head).Compared to the existing workarounds:
--force_high_performance_gpu)--use-angle=gl)--disable-gpu-compositing)Cmd + -)app.asar, so Electron's AsarIntegrity check is unaffected; a LaunchAgent re-applies the wrapper after every Codex auto-update.Posting in case it helps anyone else stuck on this until OpenAI removes the
backdrop-filterusage (or Chromium handles the IOSurface failure path).This is still an issue. When will we get a solution?
Codex Desktop Intel HiDPI rendering bug
Recommended target: comment on https://github.com/openai/codex/issues/18341
Related issues:
Summary
Codex Desktop on macOS Intel renders a large translucent/blurred overlay or blank blocking region when the app window is moved to a HiDPI/2K/4K-scaled external display. The same window renders normally on a 1080p display. Moving the window between displays toggles the issue immediately.
This looks like an Electron/Chromium GPU compositor or display-scale-factor bug, not a conversation/content issue.
Environment
Symptoms
Steps to reproduce
Expected behavior
The Codex UI should render the same way regardless of display resolution, display scale factor, or monitor refresh rate.
Actual behavior
Codex renders incorrectly only on the HiDPI/2K/4K-scaled display path. The visible failure is a persistent large translucent/blurred/blank overlay blocking the app UI.
Workarounds tested or prepared
opaqueWindows = truein~/.codex/config.toml.~/.codex/.codex-global-state.json.~/Library/Application Support/Codex/.Diagnostics
Recent logs are under:
The current app process includes a separate
Codex Helper --type=gpu-process, and the issue tracks display movement/scale rather than app content.Hi there, we have received multiple reports of this now and are actively investigating. Thank you all for the detailed repro instructions in the thread.
It seems to have been fixed.
version: 26.527.60818 (3437)
<img width="1023" height="968" alt="Image" src="https://github.com/user-attachments/assets/ea02885d-f62a-4152-84b4-6b6d4d0be8f7" />
Closing as resolved in current releases.