CLAUDE.md vs AGENTS.md
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
How the two changed over the past year, from the git history of 5,786 files: CLAUDE.md best practices from 5,786 real files.
What the public corpus contains
693,769 files collected from 126,386 public GitHub repositories. Collected through .
| File type | Files collected | Examples |
|---|---|---|
| CLAUDE.md | 48,642 | Browse CLAUDE.md |
| AGENTS.md | 57,996 | Browse AGENTS.md |
These counts describe the files we collected. They do not measure all GitHub repositories, unique projects using each format, or which format works better.
Read the source data
