Answers
Codex reads 32 KiB of AGENTS.md and cuts the rest: raise project_doc_max_bytes or trim
Published
Codex reads at most 32 KiB of project instructions by default, one budget shared by every AGENTS.md from the repository root down, and it cuts the file that crosses it mid-text and drops the rest. 30,080 public AGENTS.md files are over that limit on their own. Raise project_doc_max_bytes in ~/.codex/config.toml, or cut the file.
For Codex. Vendor facts are from the pages linked below, read on November 18, 2026.
Two fixes
- Measure:
wc -c AGENTS.mdplus every nested AGENTS.md on the path to the folder you start Codex in. The budget is the total. - Raise the cap in
~/.codex/config.tomlwithproject_doc_max_bytes = 65536. In our test this brought back both a 33.6 KB root file and the nested file it had pushed out. - Or cut: OpenAI’s best-practices guide says a short, accurate AGENTS.md beats a long file of vague rules, and the prompt behind
/initasks for 200 to 400 words. - Move folder-specific rules into that folder’s AGENTS.md, which loads only when you start Codex there or below.
- Run
codex debug prompt-input "hi"to print exactly what the model receives. Codex 0.168.0 and later also warn in the session when a file is truncated.
# ~/.codex/config.toml
project_doc_max_bytes = 65536The numbers
| Measure | Value | Source |
|---|---|---|
| Codex default project_doc_max_bytes | 32 KiB, all project files together | Codex AGENTS.md docs |
| Public AGENTS.md files over 32 KiB on their own | 30,080 (2.6% of all) | Harbor study, 18 Oct 2026 |
| Public AGENTS.md files over 24 KiB | 51,840 (4.5%), one nested file from the limit | Harbor study, 18 Oct 2026 |
| Median AGENTS.md length | 63 lines; 1 in 10 longer than 287 | Harbor study, 18 Oct 2026 |
| AGENTS.md files longer than 200 lines | 17.8% (weighted, of 1,966) | Harbor study, 18 Oct 2026 |
Study figures are weighted estimates from 1,935 CLAUDE.md and 1,970 AGENTS.md files sampled from public GitHub repositories on 18 October 2026, with GitHub's own counts for the totals. Every figure is in the study's CSV, and the method is in the study.
What the docs say
- Codex: Custom instructions with AGENTS.md: project_doc_max_bytes is 32 KiB by default. Codex reads one file per folder from the project root and stops searching once it reaches your current directory.
Where Harbor fits
Harbor connects Claude Code, Codex, Cursor and GitHub Copilot (the CLI and VS Code agent mode; the cloud agent is not supported yet) through hooks and an MCP server. Through Codex’s own hooks it serves only the rules that apply to the task, at most three ranked rules per prompt, so the team’s rules do not compete for one 32 KiB budget. Codex runs a hook only after you trust it; harbor init records that trust and harbor doctor says when it is missing. Each rule shows how often it was served and how often an answer cited it. A citation is evidence a rule was used, not proof it was obeyed.
Read next
- Why Codex ignores AGENTS.md, every cause
- How long should a rule file be?
- The study behind the numbers
- Antigravity truncates each rule file at 24,000 bytes and caps always-on rules at 20,000 tokens
- Copilot code review no longer stops at 4,000 characters of instructions: the limit was removed in June 2026
- Keep each Cursor rule under 500 lines and split the rest by file pattern
- Leave the directory tree out of CLAUDE.md and AGENTS.md: it goes stale and the agent can list files itself
- Every answer, by agent and problem
Questions
Is there a size limit on AGENTS.md in Codex?
Yes. project_doc_max_bytes defaults to 32 KiB for all project AGENTS.md files together, spent from the root down. The global ~/.codex/AGENTS.md is not counted against it.
What happens when AGENTS.md is over 32 KiB?
Codex keeps the start, cuts the file that crosses the budget mid-text and drops any files after it. Before Codex 0.168.0 the only sign was a line in a log file; 0.168.0 and later warn in the session.
How do I increase the AGENTS.md limit in Codex?
Set project_doc_max_bytes = 65536 (or another byte count) as a top-level key in ~/.codex/config.toml, then start a new session.
How many AGENTS.md files are too big for Codex?
GitHub code search counted 30,080 public AGENTS.md files over 32 KiB on 18 October 2026, 2.6 percent of all of them, and 51,840 over 24 KiB.