AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Worked for most · soon

firecrawlAGENTS.md

firecrawl/pdf-inspector/AGENTS.md

Fast PDF text extraction to structured Markdown. CLI binary: pdf2md. Detection binary: detect-pdf. All three must pass before committing.

No other project uses it yet

An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.

At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.

Setup and test commands, code style, and the rules a new contributor would need to know.

Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.