codex - 💡(How to fix) Fix Windows Codex App 26.409.7971.0 regression: project .codex/config.toml developer_instructions no longer override ~/.codex/config.toml [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#18259Fetched 2026-04-17 08:30:41
View on GitHub
Comments
2
Participants
3
Timeline
7
Reactions
0
Author
Timeline (top)
labeled ×5commented ×2

Root Cause

This is severe because instruction layering is a core workflow and safety boundary. If repo-local developer_instructions lose precedence, the desktop app can silently apply the wrong developer policy for a repository.

Fix Action

Fix / Workaround

Current workarounds are not acceptable as a real fix:

  • duplicating project rules into ~/.codex/config.toml
  • moving the most critical rules into AGENTS.md
  • abandoning the desktop app for CLI in repos that depend on strict project-local instruction overrides

Code Example

developer_instructions = """
Reply with exactly: GLOBAL
"""

---

developer_instructions = """
Reply with exactly: PROJECT
"""
RAW_BUFFERClick to expand / collapse

What version of the Codex App are you using (From “About Codex” dialog)?

Windows Store package on this machine:

  • OpenAI.Codex_26.409.7971.0_x64__2p2nqsd0c76g0
  • version: 26.409.7971.0

What subscription do you have?

Not material to the repro.

What platform is your computer?

Microsoft Windows 11 Pro 10.0.26100 x64.

What issue are you seeing?

This appears to be a regression introduced by the Windows desktop update that rolled out on April 16, 2026.

In Codex App on Windows, project-scoped developer_instructions from ./.codex/config.toml no longer override the user-level ~/.codex/config.toml developer_instructions.

This is severe because instruction layering is a core workflow and safety boundary. If repo-local developer_instructions lose precedence, the desktop app can silently apply the wrong developer policy for a repository.

The expected layered behavior is:

  • user-global defaults come from ~/.codex/config.toml
  • project-local overrides come from ./.codex/config.toml
  • for the same key, the project-local value should win in that repository

In the current Windows Codex App build, the effective behavior appears to be the opposite for developer_instructions: the user-level value continues to dominate.

What steps can reproduce the bug?

  1. In ~/.codex/config.toml, set an unmistakable global instruction, for example:
developer_instructions = """
Reply with exactly: GLOBAL
"""
  1. In a trusted project, create ./.codex/config.toml with a conflicting project-local instruction, for example:
developer_instructions = """
Reply with exactly: PROJECT
"""
  1. Confirm the project is trusted.
  2. From that project root, compare behavior between Codex CLI and Codex App.
  3. Start a fresh thread in Codex App for that project.
  4. Ask a trivial prompt that makes the winning instruction obvious.

What is the expected behavior?

For a trusted project, the project-local ./.codex/config.toml developer_instructions should override the user-level ~/.codex/config.toml developer_instructions, matching layered config expectations.

In the example above, the effective instruction in that project should be PROJECT, not GLOBAL.

Actual behavior

On Windows Codex App 26.409.7971.0, the session behaves as if the user-level ~/.codex/config.toml developer_instructions still wins, even in a trusted project with its own ./.codex/config.toml override.

Additional information

This looks related to the broader history of Desktop/App config-layer drift, but it is not the same symptom as older reports.

Related issues:

  • #11004 - Codex App: developer_instructions from config were not attached to app-created threads
  • #13025 - Desktop ignored project .codex/config.toml and only loaded ~/.codex/config.toml for MCP config
  • #17110 - Desktop did not honor project-scoped .codex/config.toml OTel config
  • #14689 - Codex App / CLI config drift around config.toml

Why this one is especially severe:

  • it affects developer_instructions, not just MCP or telemetry config
  • it can invert repository-specific workflow/safety policy
  • it is easy to miss because the app still starts and works, but with the wrong instruction layer winning

Current workarounds are not acceptable as a real fix:

  • duplicating project rules into ~/.codex/config.toml
  • moving the most critical rules into AGENTS.md
  • abandoning the desktop app for CLI in repos that depend on strict project-local instruction overrides

Please treat this as a regression in Desktop/App config precedence on Windows.

extent analysis

TL;DR

The Windows Codex App 26.409.7971.0 has a regression where project-scoped developer_instructions from ./.codex/config.toml no longer override user-level ~/.codex/config.toml developer_instructions, and a fix or workaround is needed to restore the expected layered behavior.

Guidance

  • Verify the issue by following the steps to reproduce the bug, including setting global and project-local instructions in their respective config.toml files and comparing behavior between Codex CLI and Codex App.
  • Check the related issues (#11004, #13025, #17110, #14689) to see if any of the fixes or workarounds mentioned there can be applied to this specific problem.
  • Consider using the Codex CLI instead of the desktop app for repositories that depend on strict project-local instruction overrides as a temporary workaround.
  • Review the config.toml files for any syntax errors or inconsistencies that might be contributing to the issue.

Example

No code snippet is provided as the issue is related to configuration files and their precedence.

Notes

The issue seems to be specific to the Windows Codex App 26.409.7971.0 and might be related to the broader history of Desktop/App config-layer drift. The provided workarounds are not acceptable as a real fix, and a proper solution is needed to restore the expected behavior.

Recommendation

Apply a workaround, such as using the Codex CLI for repositories that depend on strict project-local instruction overrides, until a fix is available for the Windows Codex App. This is because the current workarounds are not acceptable and the issue can invert repository-specific workflow/safety policy.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING