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

Grinv

GrinvReads credentialsAGENTS.md

tmdb-mcp

Grinv/tmdb-mcp/AGENTS.md

Single source of truth for working on this repository — for any model or agent. CLAUDE.md only references this file (@AGENTS.md); keep all shared guidance here, not in CLAUDE.md. (For end-user/runtime docs, see README.md.) A TypeScript MCP server for movie/TV data. Hybrid backend: TMDB is the backbone (search, metadata, people, trending) via its v3 REST API with a v4 Read Access Token; OMDb is optional enrichment supplying IMDb/Rotten Tomatoes/Metacritic ratings, keyed by the imdb_id TMDB returns. Design rationale (why two…

529d agoReviewMount

GrinvReads credentialsAGENTS.md

steam-games-mcp

Grinv/steam-games-mcp/AGENTS.md

Single source of truth for working on this repository — for any model or agent. CLAUDE.md only references this file (@AGENTS.md); keep all shared guidance here, not in CLAUDE.md. (For end-user/runtime docs, see README.md.) A TypeScript MCP server for Steam. Hybrid backend, mirroring the mal-mcp/tmdb-mcp pattern: store/game reads go through the Steam Storefront API (store.steampowered.com/api/) which needs *no key*, while player data (profiles, libraries, achievements, friends) uses the *official Steam Web API* (api.steampowered.com) which needs a *free key**. Design rationale…

428d agoReviewMount

GrinvAGENTS.md

mal-mcp

Grinv/mal-mcp/AGENTS.md

Single source of truth for working on this repository — for any model or agent. CLAUDE.md only links here (@AGENTS.md); keep all shared guidance in this file, not in CLAUDE.md. (For end-user/runtime docs, see README.md.) A TypeScript MCP server. Hybrid backend: read tools call the free Tenrai API (no auth; an unofficial MyAnimeList mirror). Personal-list tools call the official MyAnimeList API (user token). Eleven read tools (search/top/seasonal/recommendations/details/anime statistics) additionally fall back to the official API via just a Client ID…

22mo agoReviewMount

GrinvAGENTS.md

anilist-mcp-server

Grinv/anilist-mcp-server/AGENTS.md

Single source of truth for working on this repository — for any model or agent. CLAUDE.md only links here (@AGENTS.md); keep all shared guidance in this file, not in CLAUDE.md. (For end-user/runtime docs, see README.md.) A TypeScript MCP server for the AniList GraphQL API. Reads (search/details/genres/tags/recommendations/threads/activity/public user data) call the public GraphQL endpoint directly and need no credentials. Personal-list and social tools (add/update/remove list entries, favourites, follow, posting/deleting activity or threads, updateuser, getnotifications) act on the authenticated user's own AniList…

12mo agoReviewMount

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.