[Codex App] Move projectless chat workspaces out of Documents and make the location configurable
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
What variant of Codex are you using?
Codex App on macOS
What feature would you like to see?
Please change the default location used for projectless chat workspaces and allow users to configure it.
This request has two parts:
- Move the default workspace root out of
~/Documents. - Allow users to override the default location in the Codex App settings or through a supported configuration option.
Currently, starting a chat without selecting a project automatically creates a generated workspace under:
~/Documents/Codex/YYYY-MM-DD/<chat-directory>
On macOS, ~/Documents is commonly managed by iCloud Drive when Desktop & Documents syncing is enabled. This causes generated projectless-chat workspaces, temporary files, and output files to be synchronized automatically.
Generated application workspaces should not use a commonly synchronized user-document directory by default. Users may not discover the behavior until a significant amount of data has already been uploaded.
A more appropriate platform-specific default could be:
- macOS:
~/Library/Application Support/Codex/Workspaces - Windows:
%LOCALAPPDATA%\Codex\Workspaces - Linux:
$XDG_DATA_HOME/codex/workspacesor~/.local/share/codex/workspaces
In addition to changing the default, please provide either:
- A setting in the Codex App for selecting the projectless chat workspace root; or
- A supported
config.tomloption, such asprojectless_workspace_root.
Suggested migration behavior:
- Newly created projectless chats should use the new platform-specific default.
- Existing chats should continue referencing their original directories.
- Existing directories should not be moved automatically without user confirmation.
- Users should be able to choose a custom local directory.
- The app should validate that the selected directory is writable.
- The existing
work/andoutputs/directory structure should remain unchanged.
Additional information
Environment:
- Codex App version: 26.818.41509
- Platform: Darwin 25.6.0 arm64 arm
- The macOS
Documentsdirectory is managed by the iCloud File Provider
In my case, ~/Documents/Codex has grown to approximately 1.7 GB across roughly 219 generated chat directories, all of which are subject to iCloud synchronization.
Selecting a dedicated project outside Documents is a possible workaround, but it changes the projectless-chat workflow and requires a project to be selected.
Suggested behavior:
- The setting should apply to newly created projectless chats.
- Existing chats should continue referencing their original directories.
- The app should validate that the selected directory is writable.
- The existing
work/andoutputs/directory structure should remain unchanged.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the Codex App entry point that creates projectless chat workspaces and the settings or config handling for user-selected paths. Verify the platform-specific default, preservation of existing chat directories, writable-directory validation, and unchanged work/ and outputs/ structure; done means new chats use the configured location without moving existing data.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- macos, rust
- Domain
- desktop
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100