Skip to content

Mac app shows persistent blurred/translucent overlay below composer #18341

Closed

Description

@vulcanhelix

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.

Image

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

Activity

  1. added
    appIssues related to the Codex desktop app
    on Apr 17, 2026
  2. kashifamingit commented on Apr 17, 2026

    @kashifamingit

    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

  3. vulcanhelix commented on Apr 17, 2026

    @vulcanhelix
    Author

    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.

    Image
  4. kashifamingit commented on Apr 17, 2026

    @kashifamingit

    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.

  5. ectobaldus commented on Apr 17, 2026

    @ectobaldus

    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.

  6. QuantumQuill77-glitch commented on Apr 17, 2026

    @QuantumQuill77-glitch

    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.

  7. carlbberg commented on Apr 18, 2026

    @carlbberg

    Very, very slow.

  8. kashifamingit commented on Apr 21, 2026

    @kashifamingit

    Any update regarding the issue?

  9. jawad-ul-hassan commented on Apr 21, 2026

    @jawad-ul-hassan

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

  10. gongqij commented on Apr 22, 2026

    @gongqij

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

  11. shrijit37 commented on Apr 22, 2026

    @shrijit37

    same issue

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

  12. jawad-ul-hassan commented on Apr 23, 2026

    @jawad-ul-hassan

    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)

    Image Image
  13. stonezzz commented on Apr 24, 2026

    @stonezzz

    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.

  14. BobbyBishopCodes commented on Apr 24, 2026

    @BobbyBishopCodes

    Same issue.

  15. 12 remaining items

  16. boilingstar commented on May 2, 2026

    @boilingstar

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

  17. gongqij commented on May 2, 2026

    @gongqij

    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.

  18. stonezzz commented on May 2, 2026

    @stonezzz
  19. changed the title [-]Mac app shows persistent blurred/translucent overlay below composer on Intel Mac (macOS 15.0.1, 0.122.0-alpha.1)[/-] [+]Mac app shows persistent blurred/translucent overlay below composer[/+] on May 4, 2026
  20. sanyue-dev commented on May 6, 2026

    @sanyue-dev

    exact same issue

  21. EnzanNoMetsuke commented on May 11, 2026

    @EnzanNoMetsuke

    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.
  22. Dragon-zg commented on May 19, 2026

    @Dragon-zg

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

    环境

    • mac处理器:2.2 GHz 六核Intel Core i7
    • 内存:16 GB 2400 MHz DDR4
    • macOS: 12.7.6 (21H1320)版本
    • Codex 应用版本:26.513.31313
    Image
  23. Uncle-Gao commented on May 19, 2026

    @Uncle-Gao

    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; }
    3. 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).

  24. noahvandal commented on May 21, 2026

    @noahvandal

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

  25. shiboxuan commented on May 25, 2026

    @shiboxuan

    Codex Desktop Intel HiDPI rendering bug

    Recommended target: comment on #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.

  26. self-assigned this
    on May 27, 2026
  27. apatwa-oai commented on May 27, 2026

    @apatwa-oai

    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.

  28. gongqij commented on Jun 2, 2026

    @gongqij

    It seems to have been fixed.
    version: 26.527.60818 (3437)
    Image

  29. ax-openai commented on Jun 12, 2026

    @ax-openai

    Closing as resolved in current releases.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

appIssues related to the Codex desktop appbugSomething isn't working

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions