Awesome Agents.md

A curated list of real‑world AGENTS.md files, templates, guides and tools for OpenAI Codex / agents‑based projects. Contributions welcome! Please read the contributing guidelines first.

Contents

• Official Samples
• Community Examples
• Templates
• Guides & Articles
• Tools

Official Samples

• Introducing Codex – OpenAI Blog – First-party explanation of Codex and AGENTS.md usage.
• OpenAI Codex – Official AGENTS.md – Root‑level file showing tests, environment and safety rules.

Community Examples

• Improving our Java SDK with Codex – Temporal Blog – Explains the addition of AGENTS.md in a real production SDK.
• Temporal Java SDK – AGENTS.md – Production‑grade build/test instructions for a Java library.

Templates

• Advanced AGENTS.md – A feature‑rich template with testing, safety and style rules.
• Minimal AGENTS.md – A concise, no‑frills starting point.

Real‑world Examples

• Next.js Shop – Monorepo TypeScript e‑commerce demo with pnpm workspaces.
• Rust API Skeleton – Axum‑based REST API showcasing integration tests and nix setup.

Guides & Articles

• A Quick Look at ChatGPT Codex – Apidog Blog – Visual overview with a five-point minimal template.
• ChatGPT Codex: The Missing Manual – Latent Space – Detailed format guidance in 'Groom your Agents.md'.
• Create an AGENTS.md file in your repo – Medium (Joe Njenga) – Shares a sub-30 line minimal template with examples.
• OpenAI Codex: A Guide With 3 Practical Examples – DataCamp – Step-by-step tutorial including three AGENTS.md samples.
• The killer feature of OpenAI Codex is parallelism – Medium (Morgan Linton) – Highlights AGENTS.md as key to Codex success.
• Writing effective AGENTS.md files – Practical tips to accelerate agent onboarding.

Tools

• awesome‑lint – Linter that enforces Awesome List style.
• lychee – Fast, configurable link checker.

License

This work is released under CC0‑1.0. See LICENSE.