Support AGENTS.local.md

Open 💬 2 comments 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

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

View original on GitHub ↗

2 Comments

kevinhwang · 2 months ago

I filed https://github.com/openai/codex/issues/28739 which includes this request but also some other features of Claude Code's CLAUDE.md handling, like @file imports / reference expansion, as well as source-file attribution / provenance labels. My issue includes a proposed fix, but I don't have permission to open a PR.

While we wait on OpenAI to pick this up, I implemented this is a small Codex plugin in the meantime.

mduchev · 23 days ago

Hopefully this gets implemented soon!