MDM docs mention non-existant `codex config` command

Resolved 💬 1 comment Opened Jan 28, 2026 by kdhira Closed Jan 28, 2026

What is the type of issue?

Documentation issue/question with https://developers.openai.com/codex/security#mdm-setup-workflow, potentially a product bug/gap

What is the issue?

Reference:
https://developers.openai.com/codex/security#mdm-setup-workflow

In the developer documentation portal for Codex, the MDM setup in the Security section references a setup to run "codex config show --effective" as a verification setup check if MDM provisioned configuration on MacOS devices were effective, however running such codex config show --effect command gives me a "unrecognised argument" error:

$ codex config show --effective
error: unexpected argument 'show' found

Usage: codex [OPTIONS] [PROMPT]
       codex [OPTIONS] <COMMAND> [ARGS]

For more information, try '--help'.

And running codex config creates a new Codex session with "config" being the initial user message - so to suggest there is no logic to pick up config as a sub command.

Question here is: Is codex config .../codex config show --effective meant to be a valid command and implemented in Codex?

  • If so, this is likely more a product bug/gap, not a documentation issue...
  • If not, then this documentation should be updated to remove reference to the non-existent command - which then my follow up question would be: what can we do instead to test/show whether the MDM configuration has been applied successfully and is being read by Codex?

Where did you find it?

https://developers.openai.com/codex/security#mdm-setup-workflow

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗