{
  "id": 19230372,
  "title": "How to write an AGENTS.md for Codex (with a starter template)",
  "url": "https://urgent.news/2026/11/09/how-to-write-an-agents-md-for-codex-with-a-starter-template",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-11-09T22:19:31.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/pickaplugin/how-to-write-an-agentsmd-for-codex-with-a-starter-template-ibb"
  },
  "original_language": "en",
  "account": "Here's a guide on creating an AGENTS.md file specifically for Codex, complete with a starter template:\n\nWhat is AGENTS.md?\nAGENTS.md is a simple Markdown file that Codex checks before interacting with your repository. Consider it a briefing note for a new team member to help them understand how to set up and work on your project.\n\nKey elements to include in AGENTS.md:\n\n1. Setup instructions:\n- Installation command: `npm install`\n- Development server: `npm run dev`\n- Running tests: `npm test` (mandatory before each commit)\n- Linting: `npm run lint`\n\n2. Coding style guidelines:\n- Use TypeScript with strict mode and avoid using `any` unless necessary\n- Favor small, well-named functions and exports\n\n3. What not to modify:\n- Generated files located in the `dist/` folder\n- `.env*` files containing sensitive information\n- `migrations/` folder, unless the task specifically involves migrations\n\n4. Contributing guidelines:\n- One focused change per pull request (PR)\n- Commit messages in imperative mood, under 72 characters\n\nHow Codex processes AGENTS.md:\n- The file is located at ~/.codex/AGENTS.md for global defaults\n- Codex sequentially reads AGENTS.md files from the repository root down to the current working folder\n- Later files override earlier ones; for example, AGENTS.override.md will take precedence over AGENTS.md in the same folder\n- The total size of combined AGENTS.md files is limited to 32 KiB\n\nAdditional tips:\n- Commit AGENTS.md to the repository root so all team members and agents share the same rules\n- If you don't want to start from scratch, use the free in-browser AGENTS.md generator, which creates a file based on a few simple questions\n\nRemember, AGENTS.md is an open standard used by various tools like Cursor, Aider, Jules, and Zed. By providing clear instructions and guidelines, you help ensure consistency and make onboarding new contributors easier.",
  "summary": "Disclosure: I run PickAPlugin , an independent catalog of ChatGPT and Codex plugins. This is adapted from our guide on the same topic. AGENTS.md is a plain markdown file that Codex reads before it touches your repo. Think of it as the note you'd leave a new teammate on their first day. What to put in it How to install, run, test and lint, with the exact commands. Code style rules that aren't…",
  "key_points": [
    "AGENTS.md is a Markdown file guiding Codex on repository setup and workflow",
    "Setup instructions include npm install, npm run dev, npm test, and npm run lint",
    "Coding style guidelines specify TypeScript with strict mode, small well-named functions"
  ],
  "editors_take": null,
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}