r/codex • u/daiweilu • 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!
- Live doc: https://d6u.github.io/agent-cli-config-guide/ (tip: click the Codex filter at the top to focus purely on Codex)
- Source: https://github.com/d6u/agent-cli-config-guide
What's covered for Codex:
- Instructions: Global → Repo Root → CWD walk,
AGENTS.override.mdvs.AGENTS.md/ fallbacks, and the 32 KiBproject_doc_max_bytescap - Config & MCP (
config.toml): CLI-cflags, trusted nested.codex/config.toml, standalone--profilefiles, recursive[mcp_servers.*]table merging (with arrays replacing), and adminrequirements.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.
•
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.