r/codex • • 17h ago

Showcase Interactive config & precedence reference for Codex (CLI + Desktop App): AGENTS.md, config.toml, MCP, and Skills

I put together a single-file interactive reference doc for Codex (CLI + Desktop App) configs because I found it really helpful to have all the file locations, merge rules, and precedence behavior in one place. Sharing it here in case anyone else finds it useful!

What's covered for Codex:

  • Instructions: Global → Repo Root → CWD walk, AGENTS.override.md vs. AGENTS.md / fallbacks, and the 32 KiB project_doc_max_bytes cap
  • Config & MCP (config.toml): CLI -c flags, trusted nested .codex/config.toml, standalone --profile files, recursive [mcp_servers.*] table merging (with arrays replacing), and admin requirements.toml
  • Skills & Views: .agents/skills/ discovery & coexistence ([[skills.config]]), an interactive precedence simulator, copyable TOML/Markdown snippets, and a macOS/Windows/Linux path toggle

Hope the community finds it helpful—feel free to share feedback or open a PR if anything looks off!

Disclosure: I used AI to help build the page and draft this post, though the ideas and structure are mine and I verified the details against the official docs as thoroughly as I could.

0 Upvotes

2 comments sorted by

•

u/dexterthebot 17h ago

You might want to consider listing your project on the weekly Show-Us-What-You-Built post. Look out for it on Tuesday/Wednesday. Highest commented project wins a week promotion on r/Codex and gets on the Hall of Fame sidebar. See below for last week's winner.**


Light Wars AR: real-life laser tag app with no extra gear. Your phone is the gun and your room is the map. Play up to 6 friends in the same room, or fight drone waves and bosses solo. The vision models run on the phone, and camera frames never leave it. Free on iPhone and Android.

Website: https://lightwarsar.com

iPhone: https://apps.apple.com/us/app/light-wars-ar-laser-tag-party/id6508168951

Android: https://play.google.com/store/apps/details?id=com.lasertag.lightwars.

Contact: contact@lightwarsar.com

1

u/VShulcz 5h ago

Worth adding ~/.codex/hooks.json to the Codex tab too. Codex silently ignores hook entries until you open interactive mode once and approve them under /hooks, and that catches codex exec as well. Listing enabled_tools and disabled_tools under [mcp_servers.<name>] would also fit right into the MCP section.