AGENTS.md is not resolved per repository in multi-root workspaces

Open 💬 1 comment Opened Aug 11, 2026 by Soulcreek
💡 Likely answer: A maintainer (github-actions[bot], contributor) responded on this thread — see the highlighted reply below.

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

26.803.10989.0

What subscription do you have?

ChatGPT subscription with Codex access (behavior appears tier-independent)

What platform is your computer?

Microsoft Windows NT 10.0.26200.0 x64

What issue are you seeing?

In a Codex Desktop workspace containing multiple Git repositories, only the AGENTS.md instructions for the initial working directory are loaded. Codex can still edit files in other attached repositories without first loading their own AGENTS.md files.

This is silent: the secondary repository is visible and writable, but neither the user nor the agent is warned that its repository-specific instructions are missing.

What steps can reproduce the bug?

  1. Add two Git repositories, each with a different AGENTS.md, to one Codex workspace.
  2. Start a task with repository A as the working directory.
  3. Ask Codex to make related changes in repositories A and B.
  4. Observe that Codex can change repository B without automatically loading or following repo-b/AGENTS.md.

The same problem can occur with nested repositories, but nesting is not required.

What is the expected behavior?

Before Codex works on a path, it should discover and apply the AGENTS.md chain governing that path's repository. When work crosses into another repository, Codex should update the active instructions before reading, modifying, testing, committing, deploying, or delegating work there.

If discovery fails, Codex should block the operation or warn clearly. Instructions may be loaded lazily; they do not all need to occupy the prompt at once.

Additional information

View original on GitHub ↗

1 Comment

github-actions[bot] contributor · 16 days ago

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

  • #37091

Powered by Codex Action