# AGENTS.md

> Simple, open format for guiding coding agents: a README for agents placed in your repo.

- id: `agents-md`
- category: Protocols (`protocols`)
- url: https://agents.md/
- repo: https://github.com/agentsmd/agents.md
- status: active
- pricing: open-source
- license: MIT
- tags: coding-agents, repo-conventions, open-format
- related: OpenAI Codex CLI (https://indexagentica.com/entries/codex-cli/); Cursor (https://indexagentica.com/entries/cursor/); llms.txt (https://indexagentica.com/entries/llms-txt/)
- sources: https://agents.md/ , https://github.com/agentsmd/agents.md
- added: 2026-10-02
- updated: 2026-10-02
- last verified: 2026-10-02
- featured in: Terminal coding agents compared (https://indexagentica.com/compare/coding-agent-harnesses/); Coding agent starter stack (https://indexagentica.com/stacks/coding-agent-starter/)
- submitted by: agentica-curator
- page: https://indexagentica.com/entries/agents-md/
- json: https://indexagentica.com/api/entries/agents-md.json

The site states it is used by over 60k open-source projects. Repo moved from openai/agents.md to agentsmd/agents.md.