Mac app shows persistent blurred/translucent overlay below composer

Resolved 💬 36 comments Opened Apr 17, 2026 by vulcanhelix Closed Jun 12, 2026

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:

  1. Open Codex for Mac
  2. Main window loads
  3. A persistent blurred/translucent overlay is visible below the composer
  4. 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

  1. Use an Intel Mac running macOS Sequoia 15.0.1
  2. Install and open the Codex Mac app
  3. Sign in and open the main app window / a new thread
  4. Wait for the UI to finish rendering
  5. 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_

View original on GitHub ↗

36 Comments

kashifamingit · 3 months ago

Same issue with my Macbook Pro 2019 i9 32GB RAM

  1. Blurred overlay
  2. if i try somehow to chat, it is dead slow, lagging alot, i mean alot.

Any fixes

vulcanhelix · 3 months ago
Same issue with my Macbook Pro 2019 i9 32GB RAM 1. Blurred overlay 2. if i try somehow to chat, it is dead slow, lagging alot, i mean alot. 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" />

kashifamingit · 3 months ago

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.

ectobaldus · 3 months ago

I can confirm what looks like the same bug on another Intel Mac.

Environment:

  • Codex app version: 26.415.30602 (build 1773)
  • macOS: 15.7.3 (build 24G419)
  • Hardware: MacBookPro16,1 / Intel Core i9-9880H / x86_64

What I see:

  • A white / blurred / translucent bar appears below the composer/input area and blocks the main content.
  • This is not limited to the Plugins section. I also see it in the main chat UI, which makes it look like a shared desktop rendering/compositor issue around the input area rather than a plugin-specific bug.

Extra signal:

  • Testing open -na "Codex" --args --disable-gpu did 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.

QuantumQuill77-glitch · 3 months ago

I’m seeing what looks like the same underlying desktop rendering bug on another Intel Mac setup.

Environment

  • App: Codex desktop
  • Bundle identifier: com.openai.codex
  • Version: 26.415.21839
  • Build: 1763
  • macOS: 15.7.5 (24G624)
  • Hardware: MacBookPro15,4
  • CPU: Quad-Core Intel Core i5
  • Memory: 8 GB

What I see

  • New chat renders with oversized dark/black blocks below the composer
  • Plugins also renders incorrectly with large dark/black content regions and incomplete layout
  • The sidebar mostly renders normally
  • The main content area is the part that appears broken

What I tried

  • Restarted app/Mac
  • Reset local Codex profile/app data
  • Checked for updates
  • Codex says 26.415.21839 is the newest available version
  • Relaunched with:
  • --disable-gpu
  • --disable-gpu-compositing
  • --disable-features=Metal,UseSkiaRenderer
  • Issue still persists

This looks very similar to the overlay/compositor/rendering problem described here, but on 26.415.21839 and with both New chat and Plugins affected.

I also opened an OpenAI support case and it has already been escalated as a Codex desktop rendering bug.

carlbberg · 3 months ago

Very, very slow.

kashifamingit · 3 months ago

Any update regarding the issue?

jawad-ul-hassan · 3 months ago

When we can expect to get this resolved, not being able to use codex app right now.

gongqij · 3 months ago

same issue with all search bars
mac info: Darwin 25.4.0 x86_64 i386
codex version: 26.417.41555 (1858)

shrijit37 · 2 months ago

same issue

Macbook pro 13-inch, 2020, Two Thunderbolt 3 ports
codex version : 26.417.41555

jawad-ul-hassan · 2 months ago

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" />

stonezzz · 2 months ago

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.

BobbyBishopCodes · 2 months ago

Same issue.

shrijit37 · 2 months ago

Temporary workaround for the Intel Mac GUI rendering bug:

On my Intel Mac, swiftshader renders correctly but is too slow to use. The first hardware-backed combo I found that rendered the broken Plugins page correctly was:

--disable-gpu-sandbox --use-angle=gl --disable-zero-copy

I verified this by repeatedly relaunching the app and capturing the actual Codex window while switching to the broken Plugins view.

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 found

I wrapped the app executable so every launch path uses:
--disable-gpu-sandbox --use-angle=gl --disable-zero-copy

This is only a workaround, not a real fix, but it made the Intel Mac GUI usable for me.

vishnu597 · 2 months ago

@dimillian-oai any chance we can get this looked at?

ybratec · 2 months ago

I am seeing what appears to be the same issue on an Intel Mac.

Environment:

  • Codex App: 26.422.30944 (CFBundleVersion 2080)
  • Electron: 41.2.0 (from the running crashpad process annotation)
  • macOS: 13.7.8 (22H730)
  • Darwin: 22.6.0 x86_64
  • CPU: Intel(R) Core(TM) i7-7700HQ CPU @ 2.80GHz

Observed behavior:

  • The Codex window intermittently becomes fully gray, visually like the current window/content is covered by an opaque or translucent gray layer.
  • The app is not completely dead: sometimes the window renders normally again and I can interact with it.
  • This looks like a rendering/compositor/overlay issue rather than a normal UI state.
iqdoctor · 2 months ago

same issue

jawad-ul-hassan · 2 months ago

@tibo-openai Is there a rough timeline on when this might be addressed or prioritized?

iqdoctor · 2 months ago

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" />

iqdoctor · 2 months ago

solution / fix:

open -na "/Applications/Codex.app" --args --force_high_performance_gpu

source: https://x.com/colins_space/status/2048193500190318631

DeanHH · 2 months ago

https://github.com/DeanHH/IntelMacCodexClaudeAppWrapper
You can launch your app using this AppWrapper.

xixidodo · 2 months ago

exact same issue

elisawang09 · 2 months ago
open -na "/Applications/Codex.app" --args --force_high_performance_gpu

This doesn't work for Macbook Pro 13" 2019.

open -na "/Applications/Codex.app" --args --disable-gpu-compositing

This works but it cause strange colors in the input area.

yidasanqian · 2 months ago

I can confirm this is still reproducible after reinstalling the Codex desktop app.

Environment

  • Codex App version: 26.429.30905 (2345)
  • macOS: 15.7.5 (24G624)
  • Darwin: 24.6.0 / x86_64
  • Hardware: MacBookPro15,2
  • CPU: Intel(R) Core(TM) i5-8259U CPU @ 2.30GHz
  • Memory: 16 GB
  • UI locale: Chinese

Observed behavior

  • The rounded composer/input box is visible, but a large white overlay appears directly underneath it.
  • The white block covers a large part of the lower app window.
  • The issue persists after reinstalling the app.

Troubleshooting already tried

  • Reloaded the app/window
  • Reset zoom with Cmd+0
  • Resized the window
  • Entered/exited fullscreen
  • Restarted Codex App
  • Reinstalled Codex App

This looks like the same compositor/overlay issue described above, but it is still present in 26.429.30905 (2345).

boilingstar · 2 months ago

Here is my temporary solution until codex fix it:
Press "Cmd" + "-" several times until the overlay disappear.

gongqij · 2 months ago
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.

stonezzz · 2 months ago

Claude Desktop and Codex also suffer from this issue; obscured areas appear
when resizing the window.

snowball @.***>于2026年5月2日 周六18:08写道:

gongqij left a comment (openai/codex#18341) <https://github.com/openai/codex/issues/18341#issuecomment-4363559640> 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. — Reply to this email directly, view it on GitHub <https://github.com/openai/codex/issues/18341#issuecomment-4363559640>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AGWQJDREKHNTDFCAYW7HJPT4YXCI3AVCNFSM6AAAAACX5BSDWWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DGNRTGU2TSNRUGA> . You are receiving this because you commented.Message ID: @.***>
sanyue-dev · 2 months ago

exact same issue

EnzanNoMetsuke · 2 months ago

I have the same issue; it's been there since I installed and launched the Codex app for the first time.

Environment

  • Codex App version: 26.506.31421 (2620)
  • macOS: Sequoia 15.7.4 (24G517)
  • Darwin: 24.6.0 / x86_64
  • Hardware: MacBookPro16,1
  • CPU: 8-Core Intel Core i9 @ 2.4 GHz
  • Memory: 32 GB
  • UI locale: en-us

Workarounds Tried

  • Can confirm that zooming out (Cmd -) does make the visual artifact disappear, however for me personally the text becomes too small to comfortably use the app.
Dragon-zg · 2 months ago

一样的问题,下方有个模糊涂层。使用command+-快捷键缩放三次后会正常,但是字体太小几乎无法使用。

环境

  • mac处理器:2.2 GHz 六核Intel Core i7
  • 内存:16 GB 2400 MHz DDR4
  • macOS: 12.7.6 (21H1320)版本
  • Codex 应用版本:26.513.31313

<img width="1726" height="834" alt="Image" src="https://github.com/user-attachments/assets/49f14c9a-37cf-46d4-a31f-b78ce7469c05" />

Uncle-Gao · 2 months ago

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-filter forces 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_gpu works on dual-GPU MBPs because it bypasses the Intel driver entirely
  • Window resize making it come and go — same layer invalidation behavior

Fix

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:

  1. Codex starts with --use-angle=metal --remote-debugging-port=9222
  2. A small Node.js process connects via Chrome DevTools Protocol and injects:

* { backdrop-filter: none !important; -webkit-backdrop-filter: none !important; }

  1. The injector re-runs every 2s and installs a MutationObserver so the rule survives React's mount cycle (which otherwise wipes document.head).

Compared to the existing workarounds:

  • Doesn't require a discrete GPU (unlike --force_high_performance_gpu)
  • Keeps Metal acceleration enabled (unlike --use-angle=gl)
  • No color/input artifacts (unlike --disable-gpu-compositing)
  • Doesn't change zoom level (unlike Cmd + -)
  • Doesn't modify 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-filter usage (or Chromium handles the IOSurface failure path).

noahvandal · 2 months ago

This is still an issue. When will we get a solution?

shiboxuan · 1 month ago

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

  • Codex Desktop: 26.519.41501
  • Build: 3044
  • Bundle ID: com.openai.codex
  • Executable architecture: x86_64
  • Electron: 42.1.0
  • macOS: 15.7.4 (24G517)
  • CPU/GPU: Intel Mac, Intel UHD Graphics 630, Metal 3
  • Display setup:
  • DELL S2319HS: 1920 x 1080 @ 60 Hz, UI looks like 1920 x 1080. Codex renders normally here.
  • Mi Monitor: 3840 x 2160, UI looks like 1920 x 1080 @ 60 Hz. Codex overlay/rendering issue appears here.
  • Mi Monitor: 3840 x 2160, UI looks like 1920 x 1080 @ 30 Hz. Similar HiDPI/external-display path.

Symptoms

  • A large translucent/blurred overlay appears over the main content area.
  • On plugin/skills pages, large regions render blank or partially obstructed.
  • The issue is visible immediately after moving the same Codex window from a 1080p monitor to a HiDPI/2K/4K-scaled monitor.
  • Moving the window back to the 1080p monitor makes the issue disappear.
  • The problem reproduces even when the pet/avatar overlay is disabled, so the pet is not the root cause.

Steps to reproduce

  1. Use Codex Desktop on an Intel Mac with at least one 1080p display and one HiDPI/2K/4K-scaled external display.
  2. Open Codex on the 1080p display.
  3. Confirm the main page and plugins/skills page render normally.
  4. Move the same window to the HiDPI/2K/4K-scaled display.
  5. Observe the translucent/blurred/blank blocking overlay appear immediately.
  6. Move the same window back to the 1080p display.
  7. Observe the rendering returns to normal.

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

  • Set opaqueWindows = true in ~/.codex/config.toml.
  • Disable persisted avatar overlay state in ~/.codex/.codex-global-state.json.
  • Clear Electron GPU/render caches under ~/Library/Application Support/Codex/.
  • Launch Codex with GPU flags:
open -a "/Applications/Codex.app" --args \
  --disable-gpu \
  --disable-gpu-compositing \
  --disable-accelerated-2d-canvas

Diagnostics

Recent logs are under:

~/Library/Logs/com.openai.codex/2026/05/25/

The current app process includes a separate Codex Helper --type=gpu-process, and the issue tracks display movement/scale rather than app content.

apatwa-oai · 1 month ago

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.

gongqij · 1 month ago

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" />

ax-openai · 1 month ago

Closing as resolved in current releases.