agentleFS

AGENTS.md examples from real projects

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

Worked for most · soon
firecrawlReads credentialsAGENTS.md

firecrawl

firecrawl/firecrawl/AGENTS.md

Firecrawl is a web scraper API. The directory you have access to is a monorepo: - apps/api has the actual API and worker code - apps/*-sdk are various SDKs When…

Steady20 mentions in 2 weeks

No other project uses it yet

198k17mo agoReviewMountCreate a free account to mount
firecrawlAGENTS.md

pdf-inspector

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

20k39d agoReviewMountCreate a free account to mount
CLAUDE.md vs AGENTS.md

About AGENTS.md

What is AGENTS.md?

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

Where does it go?

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

What should it contain?

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

Does Claude Code read it?

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