Support global/centralized instructions/AGENTS.md + configuration

Open 💬 6 comments Opened Sep 18, 2025 by mrud

💡 Likely answer: A maintainer (etraut-openai, contributor) responded on this thread — see the highlighted reply below.

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_

View original on GitHub ↗

6 Comments

InsightfulFuture · 11 months ago

+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 · 7 months ago

Codex doesn't even support per-user settings for this, right? i.e. the equivalent of:

etraut-openai contributor · 7 months ago

Codex does support ~/.codex/AGENTS.md. See this documentation for details.

ithinkihaveacat · 7 months ago

Codex does support ~/.codex/AGENTS.md. See this documentation for details.

I … don't know how I missed that. Thanks for the correction.

jcrben · 5 months ago

should be closed

ilhaan · 3 months ago

I don't think this should be closed.

The ~/.codex/AGENTS.md solution shared above would only apply to a specific user. The request here is for a global file like /etc/codex/AGENTS.md similar to Claude Code's /etc/claude-code/CLAUDE.md that would apply to Codex when launched by any user on a machine.