agentleFS
Sign inStart free

AGENTS.md examples from real projects

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

Popular:code reviewtestingpdfMCP serverfrontendsecuritydocumentation
Worked for most · soon
n24q02m remove filterHiding risky files remove filter
n24q02mAGENTS.md

better-notion-mcp

n24q02m/better-notion-mcp/AGENTS.md

MCP Server for Notion API. TypeScript, Node.js >= 24, bun, ESM.

3610mo agoReviewMountCreate a free account to mount
n24q02mAGENTS.md

better-email-mcp

n24q02m/better-email-mcp/AGENTS.md

MCP Server for Email (IMAP/SMTP). TypeScript, Node.js >= 24, bun, ESM.

338mo agoReviewMountCreate a free account to mount
n24q02mAGENTS.md

better-telegram-mcp

n24q02m/better-telegram-mcp/AGENTS.md

Telegram MCP Server. Python 3.13, uv, src layout. Dual-mode: Bot API (httpx) + MTProto (Telethon). select = ["E", "F", "W", "I", "UP", "B", "C4"], ignore = ["E501"] Lenient: unresolved-import, unresolved-attribute, possibly-unresolved-reference, invalid-return-type, invalid-argument-type, not-iterable, invalid-assignment all "ignore". Lazy imports inside functions for heavy deps and to avoid circular deps.

1121d agoReviewMountCreate a free account to mount
n24q02mAGENTS.md

claude-plugins

n24q02m/claude-plugins/AGENTS.md

See README.md for end-user install. For development: Releases triggered manually via workflow_dispatch on cd.yml. Choose beta or stable. python-semantic-release handles version bump, CHANGELOG, tag, and GitHub Release. plugins/<repo>/tools.md is the only place a tool name is written down for the public. The marketplace listing and mcp.n24q02m.com/servers/<repo>/tools/ both read it, and nothing generates it: plugin.json carries no tool list, and the sync described above never copies .md files. A rename in a server is therefore invisible here until somebody types it,…

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