Codex App: add default parent folder setting for Start from scratch projects
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/
9 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
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.
Please fix this, its a nightmare that that is the first think I am searching in the app and its HARDCODED??? Really???
Please allow us to either set this in the Codex app UI or the config.toml as a global variable.
This is even more useful because without #11022 being fixed, moving them later is near-impossible.
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".
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).
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/Codexhierarchy 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.
I can reproduce the same underlying behavior on Codex Desktop for Windows.
Environment:
26.715.3651.0C:\Users\<user>\Documents\<Project Name>.C:\Users\<user>\Documents\Codex, but ideally the parent should be user-selectable.A minimal implementation could be:
Local inspection of the shipped Desktop bundle indicates that the current creation path is selected in the Electron-side
createDefaultWorkspaceRootflow 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 publicopenai/codexsource 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:
config.tomlkey?If invited, I would keep the change limited to the setting, validation/fallback behavior, project-creation path selection, and focused cross-platform tests.