Codex Desktop macOS UI renders behind dark/blurred overlay unless GPU compositing is disabled

Resolved 💬 3 comments Opened May 23, 2026 by germandavid85 Closed May 23, 2026
💡 Likely answer: A maintainer (github-actions[bot], contributor) responded on this thread — see the highlighted reply below.

Summary

Codex Desktop on macOS renders parts of the UI behind a dark/blurred/opaque layer. This makes sections of the app partially unusable. I can reproduce it on both the main prompt screen and the Plugins section.

The issue appears to be GPU compositing related. Launching Codex with --disable-gpu-compositing --disable-accelerated-2d-canvas works around the problem.

Environment

  • App: Codex Desktop
  • Codex version: 26.519.41501
  • Bundle version: 3044
  • OS: macOS 26.5
  • macOS build: 25F71
  • Mac model: MacBookPro16,1
  • CPU: 6-Core Intel Core i7
  • Memory: 16 GB
  • GPUs:
  • Intel UHD Graphics 630
  • AMD Radeon Pro 5300M
  • Install path: /Applications/Codex.app

What Happens

Large areas of the Codex UI are hidden behind what looks like a dark translucent or blurred compositing layer.

Observed in:

  1. Main Codex prompt screen
  2. Plugins section

In the Plugins section, plugin cards/text appear partially clipped or hidden behind a large dark rectangular layer. Some controls remain visible, but the content underneath is obscured and hard/impossible to use.

Expected Behavior

The UI should render normally without hidden/clipped sections or dark overlay artifacts.

Workaround That Works

Launching Codex directly with GPU compositing disabled fixes the rendering problem:

"/Applications/Codex.app/Contents/MacOS/Codex" \
  --disable-gpu-compositing \
  --disable-accelerated-2d-canvas

Attempted Fixes That Did Not Work

Cleared renderer/cache folders:

rm -rf "$HOME/Library/Application Support/Codex/GPUCache" \
       "$HOME/Library/Application Support/Codex/DawnGraphiteCache" \
       "$HOME/Library/Application Support/Codex/DawnWebGPUCache" \
       "$HOME/Library/Application Support/Codex/Code Cache" \
       "$HOME/Library/Application Support/Codex/Cache" \
       "$HOME/Library/Caches/com.openai.codex"

Reset Codex app profile:

mv "$HOME/Library/Application Support/Codex" \
   "$HOME/Library/Application Support/Codex.backup.$(date +%Y%m%d-%H%M%S)"

Tried launching with full GPU disabled:

"/Applications/Codex.app/Contents/MacOS/Codex" \
  --disable-gpu \
  --disable-gpu-compositing \
  --disable-accelerated-2d-canvas \
  --enable-logging=stderr

That fails and the app does not launch:

Error: GPU access not allowed. Reason: GPU access is disabled through commandline switch --disable-gpu and --disable-software-rasterizer.

Notes

This looks like a GPU compositor / accelerated canvas rendering issue on macOS, especially because disabling GPU compositing fixes the visual corruption while full GPU disable causes Codex to crash at startup.

Attachments

I have screenshots showing:

  1. Main prompt screen with dark blurred overlay
  2. Plugins screen with content hidden/clipped behind dark overlay

I was not able to attach them via the API path used to create this issue, but they can be added manually through the GitHub web UI if needed.

View original on GitHub ↗

3 Comments

germandavid85 · 3 months ago

<img width="848" height="468" alt="Image" src="https://github.com/user-attachments/assets/179d462c-552a-4363-85f8-78fb712802af" />
<img width="965" height="786" alt="Image" src="https://github.com/user-attachments/assets/c337869c-c56c-4474-aa2c-9c39131aaef2" />

github-actions[bot] contributor · 3 months ago

Potential duplicates detected. Please review them and close your issue if it is a duplicate.

  • #24243
  • #24027
  • #23811
  • #22952
  • #22863

Powered by Codex Action

germandavid85 · 3 months ago

Closing as duplicate after reviewing the suggested issues. This appears to be covered most directly by #24027, with related reports in #23811 and #22952.

The extra data from this report, if useful for maintainers: on Codex 26.519.41501 / bundle 3044, launching with:

"/Applications/Codex.app/Contents/MacOS/Codex" \
  --disable-gpu-compositing \
  --disable-accelerated-2d-canvas

works around the visual corruption, while full --disable-gpu prevents Codex from launching with GPU access not allowed.