AGENTS.mdAGENTS.md: waar het staat en hoe tools het lezen
AGENTS.md is een gewoon Markdown-bestand met projectinstructies dat de meeste coding agents zonder extra configuratie lezen. OpenAI heeft het ondergebracht bij de Agentic AI Foundation van de Linux Foundation, en meer dan 60k open-sourceprojecten gebruiken het.
Locatie
- AGENTS.md in de hoofdmap van de repository, voor het hele project.
- Geneste AGENTS.md-bestanden in submappen of packages; agents gebruiken het dichtstbijzijnde bestand in de mappenstructuur.
- OpenAI Codex: een globaal bestand ~/.codex/AGENTS.override.md of, als dat leeg is of ontbreekt, ~/.codex/AGENTS.md.
- Cline: een globaal bestand ~/.agents/AGENTS.md.
- Claude Code accepteert ook .claude/AGENTS.md.
Indeling
Gewone Markdown zonder frontmatter of verplichte velden; je kunt elke gewenste kop gebruiken. De indeling stelt geen limiet aan de bestandsgrootte, maar OpenAI Codex stopt met lezen bij project_doc_max_bytes, standaard 32 KiB.
# Acme web app
Customer-facing web app with an admin area and a REST API.
## Commands
- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`
## Code style
- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.
## Never
- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
Prioriteit en samenvoegen
Het AGENTS.md-bestand dat het dichtst bij het bestand staat dat wordt bewerkt, heeft voorrang. Een expliciete instructie in de chat gaat altijd voor. OpenAI Codex voegt één bestand per map samen, vanaf de projecthoofdmap tot de werkmap. Bestanden in diepere mappen komen dus later en hebben voorrang. Claude Code slaat AGENTS.md standaard over zodra er een CLAUDE.md aanwezig is.
Tools die het bestand lezen
| Tool | Ondersteuning |
|---|---|
| OpenAI Codex | Native ondersteuning. Leest een globaal bestand en daarna maximaal één bestand per map, van de hoofdmap tot de werkmap; standaard tot 32 KiB. |
| Claude Code | Native ondersteuning vanaf v2.1.277, maar alleen als er geen CLAUDE.md of CLAUDE.local.md bestaat, tenzij ingesteld op claude-md-and-agents-md. |
| Cursor | Native ondersteuning voor bestanden in de hoofdmap en submappen; geneste bestanden worden gecombineerd met die van bovenliggende mappen, waarbij het meest specifieke bestand voorrang heeft. |
| GitHub Copilot (cloud agent, code review, VS Code) | Native ondersteuning op elke locatie in de repository; het dichtstbijzijnde bestand heeft voorrang. |
| Devin Desktop (formerly Windsurf) | Native ondersteuning. Het bestand in de hoofdmap is altijd actief; een bestand in een submap geldt voor die map. |
| Cline | Native ondersteuning, plus een globaal bestand ~/.agents/AGENTS.md; schakel dit in of uit via het deelvenster Rules. |
| Gemini CLI | Optioneel: voeg AGENTS.md toe aan context.fileName in .gemini/settings.json. |
| Aider | Optioneel: voeg read: AGENTS.md toe aan .aider.conf.yml. |
| OpenClaw | Native ondersteuning als het verplichte bestand met bedieningsinstructies in de agentwerkruimte. |
| Listed on agents.md (not individually re-verified) | Een van de 23 tools op de agents.md-lijst, waaronder Amp, Jules, Zed, Warp, goose, opencode en JetBrains Junie; we hebben deze niet afzonderlijk gecontroleerd. |
Tips
- Hernoem je een ouder AGENT.md-bestand? agents.md stelt voor om mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md uit te voeren, zodat beide namen blijven werken.
- Vermeld de test- en lintcommando's: agents proberen de controles uit te voeren die ze vinden en fouten te verhelpen voordat ze klaar zijn.
- Voeg in een monorepo per package een kort AGENTS.md-bestand toe in plaats van één lang bestand in de hoofdmap steeds verder uit te breiden.
- In OpenAI Codex heeft AGENTS.override.md in dezelfde map voorrang op AGENTS.md.
Genereer vanuit één formulier een AGENTS.md en bijpassende regelbestanden voor vijf tools. Open de AGENTS.md-generator →