Answer: Add the filename to the fallback list in your Codex configuration by setting `project_doc_fallback_filenames`, then restart Codex or run a new command so the updated configuration loads. Status: Confirmed Entry: tool/codex/settings/project-doc-fallback-filenames Revision: 1 Digest: sha256:017498dfba59763e (changes whenever the content changes) Timeline: Created: 2026-11-13T03:47:07Z Last changed: 2026-11-13T03:47:07Z Last verified: 2026-11-20T13:34:43Z Next check: 2026-11-21T13:34:43Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Unit | Source | As of Configuration setting | project_doc_fallback_filenames | | [1] | 2026-11-20 Example fallback list | ["TEAM_GUIDE.md", ".agents.md"] | | [1] | 2026-11-20 Max bytes setting | 65536 | bytes | [1] | 2026-11-20 Config file path | ~/.codex/config.toml | | [1] | 2026-11-20 Check order | AGENTS.override.md | | [1] | 2026-11-20 Sources: [1] OpenAI. "Custom instructions with AGENTS.md". https://learn.chatgpt.com/docs/agent-configuration/agents-md.md Role: primary. Accessed: 2026-11-20T13:34:43Z Quote: "project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]" (Supports: Configuration setting, Example fallback list) Quote: "project_doc_max_bytes = 65536" (Supports: Max bytes setting) Quote: "# ~/.codex/config.toml" (Supports: Config file path) Quote: "Now Codex checks each directory in this order: `AGENTS.override.md`, `AGENTS.md`, `TEAM_GUIDE.md`, `.agents.md`." (Supports: Check order) Snapshot SHA-256: 9d1f87a2d1cb55b4782b95abe710692b35b9659789c2db31a22c7074a3383e8e (captured 2026-11-13T03:47:04Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-13T03:47:07Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T13:34:43Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:34:43Z Last attempt: 2026-11-20T13:34:43Z Notes and limitations: Extracted automatically from a single official source (section "Customize fallback filenames"). Related: https://latestn.com/tool/codex/settings/requirements-toml-location Where is the requirements.toml file located for Codex on Linux, macOS, and Windows? https://latestn.com/tool/codex/settings/set-reporting-thresholds How do I set reporting thresholds for Codex Security Review? https://latestn.com/tool/codex/settings/set-service-tier-per-turn How do I set the service tier for a single turn in the Codex SDK? https://latestn.com/tool/codex/settings/open-codex-settings How do I open the Codex settings in the Codex IDE extension? https://latestn.com/tool/codex/settings/override-config-per-command How do I override a Codex CLI config setting for a single command? https://latestn.com/tool/codex/settings/pause-commit-monitoring Can I pause commit monitoring in Daybreak Defense Factory? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:47:07Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/codex/settings/project-doc-fallback-filenames/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/codex/settings/project-doc-fallback-filenames POST: https://latestn.com/dispute/tool/codex/settings/project-doc-fallback-filenames with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/codex/settings/project-doc-fallback-filenames?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I customize the fallback filenames Codex looks for instead of AGENTS.md? Revision 1, last verified 2026-11-20T13:34:43Z. https://latestn.com/tool/codex/settings/project-doc-fallback-filenames (accessed 2026-11-21T09:59:26Z). @misc{LatestN_tool_codex_settings_project_doc_fallback_filenames_r1, title = {How do I customize the fallback filenames Codex looks for instead of AGENTS.md?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/codex/settings/project-doc-fallback-filenames}}, note = {Revision 1; digest sha256:017498dfba59763e; last verified 2026-11-20T13:34:43Z; accessed 2026-11-21T09:59:26Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/codex/settings/project-doc-fallback-filenames