Update codex windows WSL docs for interop.enabled & interop.appendWindowsPath

Open 💬 4 comments Opened Feb 9, 2026 by etraut-openai

💡 Likely answer: A maintainer (github-actions[bot], contributor) responded on this thread — see the highlighted reply below.

Discussed in https://github.com/openai/codex/discussions/11145

<sup>Originally posted by wbdb February 8, 2026</sup>
https://developers.openai.com/codex/windows/

This step should not be omitted from the documentation. Otherwise, users cannot use CTRL + ALT + V to insert screenshots in WSL.

sudo nano /etc/wsl.conf

[interop]
enabled = true
appendWindowsPath = true

wsl --shutdown
```</div>

View original on GitHub ↗

4 Comments

github-actions[bot] contributor · 6 months ago

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

#11120

Powered by Codex Action

daflyinbed · 5 months ago

For those who prefer not to set appendWindowsPath = true in WSL (myself included), you can simply ask Codex to create a PowerShell wrapper on the Linux side. Here's the one I use:

#!/usr/bin/env bash
set -euo pipefail

if [ -x "/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" ]; then
  exec "/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" "$@"
fi

if [ -x "/mnt/c/Program Files/PowerShell/7/pwsh.exe" ]; then
  exec "/mnt/c/Program Files/PowerShell/7/pwsh.exe" "$@"
fi

echo "powershell.exe wrapper: no Windows PowerShell executable found under /mnt/c." >&2
exit 127

Save this to ~/.local/bin/powershell.exe and make it executable.

Reference:
https://github.com/openai/codex/blob/b6499538453c28e815dd50120f7518ebe0ddf9ba/codex-rs/tui/src/clipboard_paste.rs#L195-L205

glook9001 · 16 days ago

@etraut-openai
maybe a daemon process in the background - so it can capture - user input - on clipboard paste , isWatchingWslPowershlelOrCMD --> pipe the user clipboard/ipc?

so it is robust? could be a tiny hooklet 5mb memory-ram footprint --- and just pipe the pipe case-in if the user is watching a window

Windows
┌─────────────────────────────┐
│ codex-clipboard-bridge.exe  │
│                             │
│ Win32 Clipboard API         │
│  CF_UNICODETEXT             │(ai slop)
│  CF_HDROP                   │ (ai slop)
│  CF_DIB / CF_DIBV5          │(ai slop)
│  PNG                        │ <--- isUserWatching window
└──────────────┬──────────────┘
               │ IPC
               │ request/response
               ▼
WSL
┌─────────────────────────────┐
│ Codex TUI                   │
│                             │
│ Ctrl+Alt+V                  │
│       ↓                     │ <--- IPC is watching window 
│ clipboard.read(image)       │
│       ↓                     │
│ receive PNG bytes           │
│       ↓                     │
│ attach image to prompt      │
└─────────────────────────────┘

glook9001 · 16 days ago

For those who prefer not to set appendWindowsPath = true in WSL (myself included), you can simply ask Codex to create a PowerShell wrapper on the Linux side. Here's the one I use: #!/usr/bin/env bash set -euo pipefail if [ -x "/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" ]; then exec "/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" "$@" fi if [ -x "/mnt/c/Program Files/PowerShell/7/pwsh.exe" ]; then exec "/mnt/c/Program Files/PowerShell/7/pwsh.exe" "$@" fi echo "powershell.exe wrapper: no Windows PowerShell executable found under /mnt/c." >&2 exit 127 Save this to ~/.local/bin/powershell.exe and make it executable. Reference: https://github.com/openai/codex/blob/b6499538453c28e815dd50120f7518ebe0ddf9ba/codex-rs/tui/src/clipboard_paste.rs#L195-L205

not robust --- perhaps , openai can sign a .sys kernel level NT driver - to deal with all of this detection of user input/output potenthially not bieng flaged like malware