Windows: semi-transparent sidebar causes transparent/undrawn left and top regions when maximized
Windows: semi-transparent sidebar causes transparent/undrawn left and top regions when maximized
Summary
On Codex Desktop for Windows, enabling Appearance -> Semi-transparent sidebar causes the maximized window to render incorrectly. The left sidebar area and the top/titlebar area become transparent or unpainted, so the desktop/background behind the window shows through. Disabling Semi-transparent sidebar immediately fixes the issue.
Steps to reproduce
- Open Codex Desktop on Windows.
- Go to Settings -> Appearance.
- Enable Semi-transparent sidebar.
- Optional but makes the bug easier to see: switch the theme to Dark.
- Maximize the Codex window using any of these:
- the maximize button,
Win + Up,- double-clicking the titlebar.
- Observe the left and top areas of the window.
- Disable Semi-transparent sidebar.
- Maximize again.
Expected behavior
The Codex window should paint the full app/window area when maximized. If the sidebar is translucent, the translucency should remain clipped inside the app window and should not leave the sidebar or titlebar area transparent/unpainted.
Actual behavior
When Semi-transparent sidebar is enabled and the window is maximized, the left sidebar area and top/titlebar area are transparent or not drawn correctly. The desktop or white background behind the app shows through. In dark theme this is especially visible: the app content is dark, but the left/top regions appear missing.
Turning Semi-transparent sidebar off immediately makes the maximized window render normally.
Workaround
Disable Settings -> Appearance -> Semi-transparent sidebar.
Environment
- OS: Windows 10 22H2, build 19045
- GPU: AMD Radeon RX 6750 XT
- AMD Software: Adrenalin Edition 26.5.2
- GPU driver observed in Codex diagnostics/logs: 32.0.21043.10005
- CPU: AMD Ryzen 7 5700X
- RAM: 16 GB
- Display: 2560x1440
- Codex Desktop package observed:
OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0 - Codex app/log version observed:
26.527.31326
Troubleshooting already tried
- Reinstalled Codex Desktop.
- Reset Codex user profile/cache directories:
%APPDATA%\Codex%LOCALAPPDATA%\Codex- Cleaned GPU/Shader cache under the Codex profile.
- Tried disabling Chromium/Electron hardware acceleration via Local State; this made the issue worse, so it was reverted.
- Disabled Windows MPO using
HKLM\SOFTWARE\Microsoft\Windows\Dwm\OverlayTestMode=5and rebooted; no improvement. - Verified the reliable workaround is specifically disabling Semi-transparent sidebar.
Notes
This looks like a Codex Desktop window composition/clipping bug around the semi-transparent sidebar on Windows. It does not appear to be fixed by reinstalling Codex, resetting the profile, disabling MPO, or changing GPU driver state.
Screenshots are available showing:
- Semi-transparent sidebar enabled: maximized Codex has missing/transparent left and top areas.
- Semi-transparent sidebar disabled: maximized Codex renders normally.
15 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
Confirming a very similar issue on another Windows machine with the same Codex Desktop package.
Environment:
OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0codex-cli 0.135.032.0.15.6094Behavior:
BACKGROUND TESTtext.Troubleshooting tried:
Ctrl+0.After fully restarting Codex Desktop with those variables set, the sidebar still rendered with stale background content.
Additional useful clue:
Opening the Windows system tray hidden-icons popup fixes the sidebar without changing anything inside Codex. That makes this look like a Windows repaint / DWM invalidation / app-window composition issue rather than corrupted sidebar data.
I have public-safe screenshots prepared:
BACKGROUND TESTtext visible through the Codex sidebarSmall version clarification for my repro above: the Windows/MSIX package version is \\OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0\\, while the Codex About dialog shows app version \\26.527.31326\\. Codex CLI is still \\codex-cli 0.135.0\\.
Adding another environment confirmation for this same maximized-window transparent/undrawn sidebar issue.
Environment:
OpenAI.Codex_26.527.3378.0_x64__2p2nqsd0c76g0148.0.7778.17910.0.19045x64--device-scale-factor=1)32.0.15.8180(2025-10-29)GameViewer Virtual Display Adapter(15.6.5.199)Behavior:
One useful extra data point: this confirmation is on an NVIDIA RTX 3070 system, while the original report here is on AMD RX 6750 XT. That suggests the issue is not limited to one AMD driver path.
I prepared a sanitized reproduction/annotation image locally, but
gh gist createcannot upload binary PNG files (binary file not supported) and this browser session is not signed into GitHub for drag-and-drop attachments. The image redacts private desktop icons, project names, paths, terminal output, and conversation text; it only preserves the visual structure of the failure.Attaching the sanitized reproduction/annotation image referenced in my previous comment.
It redacts private desktop icons, project names, paths, terminal output, and conversation text while preserving the relevant visual structure: the maximized Codex sidebar/left region becomes transparent or undrawn, while the main content area renders normally.
<img width="1920" height="1040" alt="Image" src="https://github.com/user-attachments/assets/668586e9-b279-4039-b562-acfab0591251" />
Follow-up after code-aware cross-review and local toggle testing:
I had Codex, Claude, and Gemini independently review the shipped bundle excerpts and the local reproduction evidence. All three reviews converge on the same likely fault boundary: this does not look like corrupted sidebar data or a sidebar layout bug, but the Windows transparent Electron window-surface / translucent-sidebar composition path.
The shipped bundle shows the
Translucent sidebartoggle is implemented as the inverse of the theme fieldopaqueWindows(checked: !theme.opaqueWindows, thenopaqueWindows: !checkedon change). When opaque mode is active, the app applies.electron-opaque, which paints the Electron root/body with solid backgrounds; when translucent mode is active, stale background pixels can show through until a Windows shell overlay such as the hidden-icons tray popup forces a repaint. That also explains why the main content area remains normal: it appears to be painted opaque, while the sidebar is the visible translucent region exposing the transparent window surface.ELECTRON_DISABLE_GPU=1did not prevent the issue, so plain GPU disable is not sufficient.WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--disable-gpuis likely irrelevant here because the shipped app is Electron/Owl Shell rather than WebView2.The highest-value next bisection would be to test the existing compositor debug switches separately:
forceOpaqueRendererBackground: if this fixes it, the transparent window surface is likely the trigger.disableBackdropBlur: if this fixes it, the culprit is more likely the backdrop-filter blur repaint path.So the current best summary is: the issue is very likely in the transparent-window / opaque-window transition and repaint invalidation boundary, with the semi-transparent sidebar being the user-visible trigger.
Adding more concrete shipped-bundle coordinates for maintainers. I could not find these symbols in the public
openai/codexrepo via GitHub code search, so these appear to come from the Desktop app bundle rather than source currently exposed in the public repo.Package:
OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0app/resources/app.asarNote: these are minified shipped bundle coordinates, so line numbers are less useful than char offsets / nearby symbols. The
sourceMappingURLcomments are present, but.mapfiles do not appear to be included in the shippedapp.asar.Relevant bundle coordinates:
webview/assets/general-settings-CFpJgfrw.jssettings.general.appearance.chromeTheme.translucentSidebar.short13569, minified line11, column1637Translucent sidebarsetting.webview/assets/general-settings-CFpJgfrw.jschecked:!y.opaqueWindows17987, minified line11, column6055opaqueWindows.webview/assets/general-settings-CFpJgfrw.jsv({opaqueWindows:!e})18025, minified line11, column6093opaqueWindowsvalue.webview/assets/app-main-5RivLWkW.css[data-codex-window-type=electron].electron-opaque473935, minified line1, column473936webview/assets/app-main-zLGqsQIL.jselectron-window-opaque-surface-changed384144, minified line2, column362630webview/assets/app-main-zLGqsQIL.jsclassList.add(\electron-opaque\)385055, minified line2, column363541opaqueWindowSurfaceEnabledis true and the window is not compact.webview/assets/app-main-zLGqsQIL.jsclassList.remove(\electron-opaque\)385097, minified line2, column363583webview/assets/general-settings-CFpJgfrw.jssettings.general.gpuTearingDebug.forceOpaqueRendererBackground.description54185, minified line11, column42253webview/assets/general-settings-CFpJgfrw.jssettings.general.gpuTearingDebug.disableBackdropBlur.description53019, minified line11, column41087Concrete fix direction suggested by the evidence:
opaqueWindowschanges or when the window becomes maximized/restored/focused, force a full repaint/invalidation of the transparent surface region.forceOpaqueRendererBackground: should confirm whether an opaque root/body eliminates the artifact.disableBackdropBlur: should confirm whether the issue is specificallybackdrop-filtercomposition rather than the transparent window surface itself.Given the readable background text showing through, my best current bet is the native transparent surface path rather than just blurred-backdrop repaint, but the two debug switches should settle that quickly.
I also encountered this problem.
I can reproduce a very similar rendering/layering problem on Windows 10 with Codex Desktop 26.527.31326.
Observed behavior:
Expected behavior: maximized Codex Desktop should fully repaint/cover its own window area, with no transparent or mixed regions from other windows.
User-provided screenshot shows the left content/sidebar and top-right titlebar/control area outlined in red where the layering breaks.
I can reproduce this too, and disabling Settings -> Appearance -> Semi-transparent sidebar immediately fixes it.
Environment:
OpenAI.Codex_26.527.7698.0_x64__2p2nqsd0c76g0148.0.7778.1792026-06-01T17:19:28.117ZBehavior:
With semi-transparent sidebar enabled, maximizing the Codex window causes the app shell/sidebar/titlebar area to become transparent or unpainted. Restoring the window makes it render normally again. Turning off semi-transparent sidebar fixes maximized rendering immediately.
This makes it look GPU-vendor independent, since the original report is AMD and this reproduction is NVIDIA.
Turning off Semi-transparent sidebar fixes the problem on light theme but not for dark theme
I encounter this issue too.
I can reproduce this consistently on Windows 10.
Environment:
Behavior:
Workaround:
This looks related to the maximized-window rendering path when sidebar translucency is enabled.
Update after checking a newer shipped Windows package and the local Settings UI.
I need to correct/clarify the debug-switch part of my earlier comments. The two
gpuTearingDebugsettings are real shipped toggles, but on my local install they are not visible in Settings, so they should not be treated as normal end-user repro toggles.Package inspected:
OpenAI.Codex_26.602.3474.0_x64__2p2nqsd0c76g0app/resources/app.asarWhat I verified from the shipped bundle:
webview/assets/gpu-tearing-debug-settings-BOMOa5dz.jsdefines these defaults as off:disableBackdropBlur: falsedisableCssMotion: falsedisableScrollFadeMask: falsedisableScrollFadeMaskAnimation: falseforceOpaqueRendererBackground: falsewebview/assets/general-settings-BtJsdRnp.jscontains aGPU Tearing Debugsection with toggles labelled:Force opaque web backgroundDisable backdrop blurte("2423536643")in the minified bundle). On my local install the Settings UI does not showGPU Tearing Debug, and the normal settings section list does not include a separategpu-tearing-debug-settingsroute.So these two switches still look like the highest-value maintainer-side bisection points, but I cannot test them as a normal public user because the debug gate is not enabled in my install.
Suggested maintainer-side bisection:
Semi-transparent sidebaron and the Codex window maximized.forceOpaqueRendererBackground. If the transparent/undrawn sidebar/top region disappears, the failure is likely in transparent-window composition / opaque renderer-background handling.disableBackdropBlur. If that fixes it instead, the failure is more likely in the backdrop-filter / blur composition path.Settings -> Appearance -> Semi-transparent sidebaroff.This slightly changes my earlier wording: the debug switches are real shipped toggles, but gated; asking public users to find them in Settings is not currently a reliable repro step.
Settings -> Appearance -> Semi-transparent sidebar off. this workaround saved me, at least i can use codex as normal for now