Global AGENTS.md does not appear to be loaded when a repo AGENTS.md is present
Resolved 💬 4 comments Opened Apr 16, 2026 by iamhectorlopez Closed Apr 30, 2026
Summary
A session honored the repository-local AGENTS.md but did not appear to load or apply the global ~/.codex/AGENTS.md.
Why this seems wrong
The global file contained cross-project defaults, including commit policy guidance. During the session, the agent followed the repo-local file and later stated that it had not checked a global AGENTS.md and only knew about the repo-specific file that had been surfaced in context.
That suggests either:
- global
AGENTS.mdis not being auto-loaded in some session types, or - global and repo
AGENTS.mdare not being merged as expected, or - the load behavior is correct but not visible enough to the agent/user.
Repro
- Put cross-project instructions in
~/.codex/AGENTS.md. - Open a repository that also has its own
AGENTS.md. - Start a Codex session in that repo.
- Ask the agent to perform a task where the global policy should materially affect behavior.
- Ask the agent which
AGENTS.mdfiles were actually loaded.
Observed
- The repo-local
AGENTS.mdwas active. - The global
~/.codex/AGENTS.mddid not appear to be active. - The agent reported that it only had the repo
AGENTS.mdin context and had not inspected a global one.
Expected
One of the following should be true:
- The global
~/.codex/AGENTS.mdis automatically loaded and merged with the repoAGENTS.md. - If global loading is intentionally disabled for a given session type, that should be clearly documented and ideally visible in-session.
- The agent should be able to distinguish between "global instructions are loaded" and "a global file exists on disk but is not active in this session."
Impact
Users may assume their cross-project defaults are active when they are not, which can change commit strategy, tool behavior, and other workflow expectations in subtle ways.
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗