Codex App: add default parent folder setting for Start from scratch projects

Open 💬 9 comments Opened Apr 28, 2026 by bryan324324
💡 Likely answer: A maintainer (github-actions[bot], contributor) responded on this thread — see the highlighted reply below.

What variant of Codex are you using?

Codex App for macOS

What feature would you like to see?

Please add a supported setting in the Codex App for the default parent folder used by Projects → Start from scratch.

Desired behavior:

  • User chooses a default project parent folder in Settings, for example:

/Users/cfs/Documents/Codex/My Projects/

  • When the user clicks Projects + → Start from scratch and enters a project name, Codex creates the new project folder under that configured parent:

/Users/cfs/Documents/Codex/My Projects/<Project Name>

  • The new project is then opened/registered in the sidebar from that folder.
  • If a same-named folder already exists, Codex can use the existing “Project 2” / unique-name behavior.

Right now, the app appears to create new scratch projects under the macOS Documents folder by default. For users who organize Codex work under a dedicated folder tree, every new project needs manual cleanup or a workaround.

Additional information

This should be an official app setting or config-supported behavior rather than requiring users to patch the installed macOS app bundle. Modifying a signed/notarized macOS app bundle invalidates code signing and can prevent the app from launching after a restart.

A reasonable UX could be:

  • Settings → General → Projects → Default project folder
  • Or a config key read by the app, such as default_project_parent

Example target path from my workflow:

/Users/cfs/Documents/Codex/My Projects/

View original on GitHub ↗

9 Comments

github-actions[bot] contributor · 2 months ago

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

  • #19909

Powered by Codex Action

BigMoonTech · 2 months ago

Please fix this embarrassing oversight openai. What the hell is Sam Altman and friends doing releasing an application that forces data into a user's documents folder with no option to configure otherwise. I watched a video and got super stoked for the New Codex release but then spent 2 hours thinking I was insane because I couldn't configure where the default save location setting was for "project from scratch", come to find out you guys didn't even program in this most basic of all basic functionalities. Pathetic. Great first experience. Fucking pissed off and crashing out.

radimbrixi · 2 months ago

Please fix this, its a nightmare that that is the first think I am searching in the app and its HARDCODED??? Really???

mikeysouthwell · 1 month ago

Please allow us to either set this in the Codex app UI or the config.toml as a global variable.

kevinb9n · 1 month ago

This is even more useful because without #11022 being fixed, moving them later is near-impossible.

maxceem · 1 month ago

I also cannot use "Start from scratch" feature because projects are created not where I keep all my projects, so I have to create folders manually first and use "Use existing folder".

zmievsa · 22 days ago

This issue happened to me as well. I'd love to fix it if codex team allows me to (i.e. PRs are invite-only).

pvieito · 9 days ago

The lack of a configurable default parent directory is extremely user-hostile. Users have different repository layouts, volumes, backup policies, security requirements, and iCloud configurations; forcing new work into a hardcoded ~/Documents/Codex hierarchy is not an acceptable default without an override.

The situation is even more frustrating because Codex explicitly verifies that the projectless root is not a symbolic link. That means users cannot configure the directory in Settings or config.toml, and they are also prevented from using the normal Unix workaround to redirect it themselves. A hardcoded path plus deliberate symlink rejection leaves users with no clean escape route.

Please add a supported default-parent/projectless-workspace setting and persist it. At an absolute minimum, resolve symlinks and validate the real target instead of rejecting them outright. The current behavior disregards user ownership of the filesystem.

Ranats · 2 days ago

I can reproduce the same underlying behavior on Codex Desktop for Windows.

Environment:

  • Codex Desktop package: 26.715.3651.0
  • Windows 11
  • Current result: creating a new local project from the Projects UI creates it directly under the Windows Documents known folder, for example C:\Users\<user>\Documents\<Project Name>.
  • Desired parent in this workflow: C:\Users\<user>\Documents\Codex, but ideally the parent should be user-selectable.

A minimal implementation could be:

  1. Add Settings → General → Projects → Default project folder with a native directory picker and a reset-to-default action.
  2. Persist the selected absolute parent directory as a Desktop-owned setting.
  3. Apply it only to newly created local projects / “Start from scratch”. Keep existing projects and projectless thread workspaces unchanged.
  4. Preserve the current OS Documents folder as the default when no custom parent is configured.
  5. If the configured directory is missing or not writable, show an actionable error and let the user reselect/reset it rather than silently creating the project elsewhere.
  6. Reuse the existing unique-name behavior for same-named folders.

Local inspection of the shipped Desktop bundle indicates that the current creation path is selected in the Electron-side createDefaultWorkspaceRoot flow using the OS Documents path, while the creation dialog only asks for the project name. I could not find that Desktop-specific implementation or its persisted workspace-state keys in the public openai/codex source tree, so a Rust-only public-repo change would not appear sufficient.

I would be willing to implement and test this as a focused external contribution. Since the repository contribution policy is invitation-only, could a maintainer clarify:

  • whether an external PR would be welcome for this issue;
  • which repository/source tree owns the Desktop project-creation flow; and
  • whether the preferred persistence surface is a Desktop setting or a documented config.toml key?

If invited, I would keep the change limited to the setting, validation/fallback behavior, project-creation path selection, and focused cross-platform tests.