openai / openai/codex

Codex Desktop fails to create/use local ChatGPT Project when WSL mode is enabled on Windows

Open
#45,724 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app bug windows-os
Dominant language
Rust
Stars
125k
Forks
19.4k
PR merge metrics
PR metrics pending

Description

Summary

On Windows, Codex Desktop fails to create or use a local ChatGPT Project when WSL mode is enabled. The same project creation succeeds immediately after disabling the WSL setting.

This appears to be related to Windows/WSL project path handling rather than the target directory being non-empty.

Environment

  • OS: Windows 11
  • Codex Desktop
  • Codex app version observed in config: 26.908.9136.0
  • ChatGPT/Codex model: gpt-5.6-sol
  • Reasoning effort: high
  • Project directories commonly live under D:\projects\...
  • WSL paths are also present, e.g. /mnt/d/projects/...

Relevant desktop config:

[desktop]
runCodexInWindowsSubsystemForLinux = true
integratedTerminalShell = "wsl"

Steps to reproduce

  1. Run Codex Desktop on Windows.
  2. Enable:
    [desktop]
    runCodexInWindowsSubsystemForLinux = true
    integratedTerminalShell = "wsl"
    
  3. Try to create/use a local ChatGPT Project backed by a Windows project directory such as:
    D:\projects\test-project
    
  4. Project creation/use fails.
  5. Disable WSL mode:
    [desktop]
    runCodexInWindowsSubsystemForLinux = false
    
  6. Restart Codex Desktop.
  7. Create/use the same project again.

Actual behavior

With WSL mode enabled, project creation/use fails.

Expected behavior

Codex Desktop should correctly map the Windows project directory into WSL and create/use the project successfully.

Workaround

Disable:

runCodexInWindowsSubsystemForLinux = true

After switching back to Windows-native execution, project creation works normally.

Additional notes

  • The issue does not appear to be caused by the target project directory containing existing files.
  • The config includes both Windows project paths (D:\projects\...) and WSL equivalents (/mnt/d/projects/...).
  • This strongly suggests a path conversion / project-root / initialization issue in the Windows + WSL integration layer.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing project creation with runCodexInWindowsSubsystemForLinux enabled and a Windows path such as D:\projects\test-project, then compare it with native Windows execution. Trace the Windows/WSL project-path and initialization flow; done means the same local project can be created and used successfully while WSL mode remains enabled.

Written by the indexing model from the issue text.

Assessment

Tech stack
linux, rust
Domain
desktop, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.