codex - 💡(How to fix) Fix Feature request: allow configuring local storage path for Codex VS Code sandbox, cache, sessions, and logs on Windows [2 comments, 3 participants]

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…
GitHub stats
openai/codex#19798Fetched 2026-04-28 06:36:59
View on GitHub
Comments
2
Participants
3
Timeline
10
Reactions
0
Timeline (top)
labeled ×6commented ×2closed ×1cross-referenced ×1

I would like to request better control over where the Codex VS Code extension stores local sandbox, cache, session, log, and runtime files on Windows.

Currently, Codex appears to create a large number of folders and files under the Windows user profile directory, such as:

  • .sandbox
  • .sandbox-bin
  • .sandbox-secrets
  • .tmp
  • archived_sessions
  • cache
  • memories
  • sessions
  • skills
  • tmp
  • vendor_imports
  • auth.json
  • config.toml
  • logs_*.sqlite
  • state_*.sqlite
  • related SQLite WAL/SHM files

I understand that some local files are required for sandboxing, session management, caching, authentication, and normal extension functionality. However, placing many Codex-related files directly under the Windows user profile directory can make the local development environment harder to manage.

Root Cause

I would like to request better control over where the Codex VS Code extension stores local sandbox, cache, session, log, and runtime files on Windows.

Currently, Codex appears to create a large number of folders and files under the Windows user profile directory, such as:

  • .sandbox
  • .sandbox-bin
  • .sandbox-secrets
  • .tmp
  • archived_sessions
  • cache
  • memories
  • sessions
  • skills
  • tmp
  • vendor_imports
  • auth.json
  • config.toml
  • logs_*.sqlite
  • state_*.sqlite
  • related SQLite WAL/SHM files

I understand that some local files are required for sandboxing, session management, caching, authentication, and normal extension functionality. However, placing many Codex-related files directly under the Windows user profile directory can make the local development environment harder to manage.

RAW_BUFFERClick to expand / collapse

What version of the IDE extension are you using?

vscode

What subscription do you have?

allow configuring local storage path for Codex VS Code sandbox, cache, sessions, and logs on Windows

Which IDE are you using?

vscode

What platform is your computer?

win10 x64

What issue are you seeing?

Summary

I would like to request better control over where the Codex VS Code extension stores local sandbox, cache, session, log, and runtime files on Windows.

Currently, Codex appears to create a large number of folders and files under the Windows user profile directory, such as:

  • .sandbox
  • .sandbox-bin
  • .sandbox-secrets
  • .tmp
  • archived_sessions
  • cache
  • memories
  • sessions
  • skills
  • tmp
  • vendor_imports
  • auth.json
  • config.toml
  • logs_*.sqlite
  • state_*.sqlite
  • related SQLite WAL/SHM files

I understand that some local files are required for sandboxing, session management, caching, authentication, and normal extension functionality. However, placing many Codex-related files directly under the Windows user profile directory can make the local development environment harder to manage.

Environment

  • OS: Windows
  • Editor: VS Code
  • Extension: Codex VS Code extension
  • Account type: ChatGPT Business

Current behavior

Codex creates multiple local folders and files under the Windows user profile directory. Over time, this can result in many Codex-related artifacts being mixed with other application and development tool configuration files.

Impact

This causes several usability and manageability concerns:

  1. The Windows user profile directory becomes harder to inspect and maintain.
  2. Codex-generated folders and files are mixed with other local development configuration files.
  3. Users may not know which files are safe to delete.
  4. C drive storage usage may grow unexpectedly.
  5. Business and Enterprise users may have stricter local storage, security, and compliance requirements.
  6. It is difficult to tell which files are required, temporary, archived, or safe to clean up.

Requested improvements

I would like to suggest the following improvements:

  1. Add an option to configure the local storage path for Codex sandbox, cache, sessions, logs, and runtime files.
  2. Store all Codex-generated files inside one clearly named dedicated directory, such as .codex or Codex, instead of creating many folders and files directly under the user profile directory.
  3. Add VS Code extension settings for:
    • Viewing the current Codex local storage path;
    • Changing the local storage path;
    • Clearing cache, old sessions, and archived sandboxes;
    • Setting a maximum local disk usage limit.
  4. Provide documentation explaining:
    • What local files Codex creates;
    • What each file/folder category is used for;
    • Which files are safe to delete;
    • How to reset or clean up local Codex state.
  5. Consider additional controls for Business and Enterprise environments.

Expected behavior

Codex should either:

  • store its local files in a single clearly scoped directory by default, or
  • allow users to choose a custom storage location, especially on Windows.

For example, users could configure Codex to store local files under:

D:\Codex

### What steps can reproduce the bug?

common using

### What is the expected behavior?

_No response_

### Additional information

_No response_

extent analysis

TL;DR

Configure the Codex VS Code extension to store local files in a single, dedicated directory to improve manageability and reduce clutter in the Windows user profile directory.

Guidance

  • Consider creating a feature request or issue in the Codex VS Code extension repository to add an option for configuring the local storage path.
  • Look for existing settings or configuration options in the VS Code extension that may allow customizing the storage location, even if not explicitly documented.
  • Evaluate the feasibility of creating a symbolic link or junction point to redirect Codex-generated files to a desired location, as a potential workaround.
  • Review the extension's documentation and support resources to see if any guidance is provided on managing local files and storage.

Example

No code snippet is provided, as the issue focuses on configuration and usability rather than code-specific problems.

Notes

The solution may depend on the specific capabilities and limitations of the Codex VS Code extension, as well as the user's Windows and VS Code configurations.

Recommendation

Apply a workaround, such as manually managing or redirecting Codex-generated files, until an official configuration option is available, as it allows for some control over the storage location without waiting for an update to the extension.

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

Codex should either:

  • store its local files in a single clearly scoped directory by default, or
  • allow users to choose a custom storage location, especially on Windows.

For example, users could configure Codex to store local files under:

D:\Codex

Still need to ship something?

×6

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

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Feature request: allow configuring local storage path for Codex VS Code sandbox, cache, sessions, and logs on Windows [2 comments, 3 participants]