Repository navigation
Support global/centralized instructions/AGENTS.md + configuration #3853
Description
What feature would you like to see?
Looking into considering codex for company wide rollout but we are missing the ability to provide a centralized AGENTS.md/INSTRUCTIONS.md file.
Ideally we would have the ability to provide one in a central place, outside of the users home directory which takes precedence.
We use this for providing guard rails and sharing company specific details.
Note: the same for configuration files, ideally basically any user configurable options would have a global configuration as well which could be managed by a mdm solution
Are you interested in implementing this feature?
Yes
Additional information
No response
Activity
InsightfulFuture commentedon Oct 1, 2025
+1. We should be able to have a ~/.codex/AGENTS.md. This would help especially on windows as I could steer the agent to not use powershell commands that don't have proper auto-approval
ithinkihaveacat commentedon Jan 11, 2026
Codex doesn't even support per-user settings for this, right? i.e. the equivalent of:
~/.gemini/GEMINI.md~/.claude/CLAUDE.mdetraut-openai commentedon Jan 11, 2026
Codex does support
~/.codex/AGENTS.md. See this documentation for details.ithinkihaveacat commentedon Jan 11, 2026
I … don't know how I missed that. Thanks for the correction.
jcrben commentedon Mar 14, 2026
should be closed
ilhaan commentedon May 23, 2026
I don't think this should be closed.
The
~/.codex/AGENTS.mdsolution shared above would only apply to a specific user. The request here is for a global file like/etc/codex/AGENTS.mdsimilar to Claude Code's/etc/claude-code/CLAUDE.mdthat would apply to Codex when launched by any user on a machine.