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
mitsuhikoAGENTS.md

agent-commands

mitsuhiko/agent-commands/AGENTS.md

Pi extensions live in ./extensions. When working in this repo, add or update extensions there. You can consult the pi-mono for reference, but do not modify code in pi-mono.

3.2k9mo agoReviewMountCreate a free account to mount
mitsuhikoAGENTS.md

gh-issue-sync

mitsuhiko/gh-issue-sync/AGENTS.md

go run ./cmd/gh-issue-sync pull cat .issues/open/NUMBER-*.md Don't use gh issue view 42, use cat .issues/open/42-*.md (unless you notice it's missing)

16710mo 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.