codex - 💡(How to fix) Fix Codex Desktop: allow users to configure the default projectless workspace root

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Codex Desktop appears to choose a hard-coded or internally computed default root for projectless/new-chat workspaces. On Windows, new projectless chats are being created under:

C:\Users\<user>\Documents\Codex\YYYY-MM-DD\new-chat...

Please add a user-facing setting, or a documented config key, that lets users choose the base directory for these projectless workspaces.

Error Message

On a Windows Codex Desktop install, a new default/projectless chat starts with a workspace path like:

Root Cause

Some users keep active development/workspace files on another drive, for example D:\Codex, due to disk capacity, backup policy, path organization, or performance. Today, the practical workaround is to move Documents\Codex and create a Windows junction/symlink back to the expected path, but that is not discoverable and feels fragile for normal users.

Fix Action

Workaround

A Windows junction can redirect the current default path:

Move-Item "C:\Users\<user>\Documents\Codex" "D:\Codex"
New-Item -ItemType Junction -Path "C:\Users\<user>\Documents\Codex" -Target "D:\Codex"

This works around the issue, but a first-class setting would be safer and more transparent.

Code Example

C:\Users\<user>\Documents\Codex\YYYY-MM-DD\new-chat...

---

C:\Users\smc\Documents\Codex\2026-05-28\new-chat-2

---

[desktop]
projectless_workspace_root = 'D:\Codex'

---

Settings -> Workspaces -> Default workspace location

---

D:\Codex\2026-05-28\new-chat

---

Move-Item "C:\Users\<user>\Documents\Codex" "D:\Codex"
New-Item -ItemType Junction -Path "C:\Users\<user>\Documents\Codex" -Target "D:\Codex"
RAW_BUFFERClick to expand / collapse

Summary

Codex Desktop appears to choose a hard-coded or internally computed default root for projectless/new-chat workspaces. On Windows, new projectless chats are being created under:

C:\Users\<user>\Documents\Codex\YYYY-MM-DD\new-chat...

Please add a user-facing setting, or a documented config key, that lets users choose the base directory for these projectless workspaces.

Why this matters

Some users keep active development/workspace files on another drive, for example D:\Codex, due to disk capacity, backup policy, path organization, or performance. Today, the practical workaround is to move Documents\Codex and create a Windows junction/symlink back to the expected path, but that is not discoverable and feels fragile for normal users.

Observed behavior

On a Windows Codex Desktop install, a new default/projectless chat starts with a workspace path like:

C:\Users\smc\Documents\Codex\2026-05-28\new-chat-2

Local investigation found:

  • D:\.codex\config.toml contains model/plugin/project trust settings, but no obvious setting for the projectless workspace base path.
  • D:\.codex\.codex-global-state.json contains thread-workspace-root-hints entries pointing existing projectless threads at C:\Users\smc\Documents\Codex.
  • The value looks like persisted thread state or a hint, not a documented user setting for future new-chat workspace creation.

Expected behavior

Users should be able to set the default base directory for projectless/new-chat workspaces, for example:

[desktop]
projectless_workspace_root = 'D:\Codex'

or through a Desktop settings UI such as:

Settings -> Workspaces -> Default workspace location

After setting it, new projectless chats would create workspaces under the chosen base path, for example:

D:\Codex\2026-05-28\new-chat

Environment

  • Codex Desktop on Windows
  • Observed app release from local process metadata: 26.519.81530
  • Windows Store package path observed locally: OpenAI.Codex_26.519.11010.0_x64__2p2nqsd0c76g0
  • OS: Windows 10, locale ko-KR, timezone Asia/Seoul

Workaround

A Windows junction can redirect the current default path:

Move-Item "C:\Users\<user>\Documents\Codex" "D:\Codex"
New-Item -ItemType Junction -Path "C:\Users\<user>\Documents\Codex" -Target "D:\Codex"

This works around the issue, but a first-class setting would be safer and more transparent.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

Users should be able to set the default base directory for projectless/new-chat workspaces, for example:

[desktop]
projectless_workspace_root = 'D:\Codex'

or through a Desktop settings UI such as:

Settings -> Workspaces -> Default workspace location

After setting it, new projectless chats would create workspaces under the chosen base path, for example:

D:\Codex\2026-05-28\new-chat

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING