guides/agents-md.md Codex Docs, 2026-02-19 20:37 UTC → 2026-02-23 18:27 UTC

1# Custom instructions with AGENTS.md1# Custom instructions with AGENTS.md

2 2 

3Give Codex extra instructions and context for your project

4 

5Codex reads `AGENTS.md` files before doing any work. By layering global guidance with project-specific overrides, you can start each task with consistent expectations, no matter which repository you open.3Codex reads `AGENTS.md` files before doing any work. By layering global guidance with project-specific overrides, you can start each task with consistent expectations, no matter which repository you open.

6 4 

7## How Codex discovers guidance5## How Codex discovers guidance