Skip to content

Honor config.toml symlinks when creating or updating config #6646

Closed
#9445
Closed
Honor config.toml symlinks when creating or updating config#6646
#9445
Labels
bugSomething isn't workingconfigIssues involving config.toml, config keys, config merging, or config updates

Description

@muyuanjin
muyuanjin
opened on Nov 14, 2025

What version of Codex is running?

codex-cli 0.58.0

What subscription do you have?

API

Which model were you using?

gpt-5-codex

What platform is your computer?

Linux 6.6.87.2-microsoft-standard-WSL2 x86_64 x86_64 (Windows 11 host with WSL2 Ubuntu)

What issue are you seeing?

Since updating to 0.58.0 the CLI recreates ~/.codex/config.toml on startup/update and silently replaces my existing symlink with a regular file containing default config. This breaks my setup where the real config lives on the Windows side and is symlinked into WSL.

What steps can reproduce the bug?

  1. On 0.57.x (or any build prior to 0.58.0) create a config on Windows and symlink it into WSL.
  2. Upgrade Codex CLI to 0.58.0. Launch codex.
  3. Inspect ls -l ~/.codex/config.toml. The symlink has been replaced by a regular file containing the new default config.

What is the expected behavior?

The upgrade/startup process should respect an existing symlink (or at least prompt before removing it) so shared configs remain usable after upgrades.

Additional information

auth.json symlinks survive the upgrade; only config.toml is rewritten. The new file always contains a [notice] block with hide_gpt5_1_migration_prompt = true. Please avoid unlinking when the target is already a symlink.

Activity

  1. muyuanjin
    added
    bugSomething isn't working
    on Nov 14, 2025
  2. github-actions
    added
    CLIIssues related to the Codex CLI
    windows-osIssues related to Codex on Windows systems
    on Nov 14, 2025

  3. github-actions commented on Nov 14, 2025

    @github-actions
    github-actionsBot
    on Nov 14, 2025 – with GitHub Actions
    Contributor

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

    Powered by Codex Action

  4. etraut-openai commented on Nov 14, 2025

    @etraut-openai
    etraut-openai
    on Nov 14, 2025
    Contributor

    The current behavior is by design, but adding support for your workflow is a reasonable feature request. Changing it from a "bug" to an "enhancement".

  5. etraut-openai
    added
    enhancementNew feature or request
    and removed
    bugSomething isn't working
    windows-osIssues related to Codex on Windows systems
    CLIIssues related to the Codex CLI
    on Nov 14, 2025
  6. etraut-openai
    changed the title [-]codex-cli overwrites config.toml symlinks[/-] [+]Honor config.toml symlinks when creating or updating config[/+] on Nov 14, 2025
  7. etraut-openai
    added
    bugSomething isn't working
    enhancementNew feature or request
    and removed
    enhancementNew feature or request
    bugSomething isn't working
    on Nov 14, 2025
  8. etraut-openai
    added a commit that references this issue on Jan 18, 2026

    Fixed symlink support for config.toml

    649f154

  9. 1 remaining item

  10. etraut-openai
    added
    bugSomething isn't working
    agentIssues related to the core agent loop
    on Jan 18, 2026
  11. etraut-openai
    closed this as completedin #9445on Jan 19, 2026
  12. etraut-openai
    added a commit that references this issue on Jan 19, 2026

    Fixed symlink support for config.toml (#9445)

    1271d45
  13. lee101
    added a commit that references this issue on Jan 25, 2026

    Fixed symlink support for config.toml (openai#9445)

    780f52e
  14. etraut-openai
    added
    configIssues involving config.toml, config keys, config merging, or config updates
    and removed
    agentIssues related to the core agent loop
    on Apr 11, 2026
  15. wangjiecloud
    added a commit that references this issue on Jun 27, 2026

    Fixed symlink support for config.toml (openai#9445)

    6d4202b
  16. lijinpei-amd
    added a commit that references this issue on Jul 10, 2026

    codex: pin model and keep absolute hook trust state

    7ec1e16
  17. v1cferr
    added 2 commits that reference this issue on Aug 19, 2026

    feat(codex): OpenAI's CLI arrives, and Codex keeps writing its own co…

    852dd34

    docs(history): the day Codex arrived, and the option built for it wen…

    fba7dbd
  18. mcwitt
    added a commit that references this issue on Sep 21, 2026

    docs: refresh scheduler-card cap and codex config.toml status

    137b52d
  19. Xantibody
    added a commit that references this issue on Sep 22, 2026

    feat(agents): hand codex the same instructions and skills as Claude

    2fef23f
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingconfigIssues involving config.toml, config keys, config merging, or config updates

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions