What AGENTS.md loads
AGENTS.md at the repo root and in subdirectories; the closest file to the edited file takes precedence.
Modelled from https://agents.md/, checked 2026-10-03. Status: beta.
Known gaps
- Each AGENTS.md reader decides how nested files combine; this view loads every AGENTS.md from the root down, nearest last (highest precedence).
- Codex-specific AGENTS.override.md replaces AGENTS.md in the same directory.
See it for your repository
Which files AGENTS.md loads for a given file, in precedence order, with token estimates:
npx threadctx explain src/index.ts --tool agents-md
Where AGENTS.md and the other agents disagree about the same directory:
npx threadctx diff