Support AGENTS.local.md
Open 💬 1 comment Opened Jun 8, 2026 by xynexus
What version of Codex CLI is running?
codex-cli 0.137.0
What subscription do you have?
Pro
Which model were you using?
all
What platform is your computer?
Ubuntu 26.04
What terminal emulator and version are you using (if applicable)?
NA
Codex doctor report
NA
What issue are you seeing?
When working in a shared repository, AGENTS.md is committed to git and shared across the team. Several times I have needed an ammendment to the AGENTS.md file that is repo local and personel to me. For example: "Please reference my local notes in ~/project1-notes/". This shouldn't be shared with the team/project. Using a global override in ~/.codex would apply this to all my projects, and editing the repo AGENTS.md would share it with my team.
Here are other examples to reference
- https://github.com/openai/codex/issues/21185
- https://github.com/anomalyco/opencode/issues/16110
- https://github.com/agentsmd/agents.md/issues/72
- https://code.claude.com/docs/en/memory (ref CLAUDE.local.md )
What steps can reproduce the bug?
NA
What is the expected behavior?
_No response_
Additional information
Stack agent files in order:
- ~/.codex
- ./.agents/
- AGENTS.md
- AGENTS.local.md
- AGENTS.override.md
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗