Docs mismatches: sandbox link, Homebrew install command, and Windows support wording
Resolved 💬 2 comments Opened Mar 20, 2026 by paulelliotco Closed Mar 20, 2026
💡 Likely answer: A maintainer (github-actions[bot], contributor)
responded on this thread — see the highlighted reply below.
Tracking a few docs inconsistencies between the public repo and current Codex docs/behavior.
Confirmed items:
docs/sandbox.mdlinks tohttps://developers.openai.com/codex/security, which is now the Codex Security product page rather than the sandbox/approvals docs. The intended destination appears to behttps://developers.openai.com/codex/agent-approvals-security.
- The repo README(s) say
brew install --cask codex, while the official quickstart saysbrew install codex. If the repo is the source of truth, the official docs should match or the repo should clarify why the cask path is preferred.
docs/install.mdstill says Windows 11 is supported only via WSL2, but the repo and current docs both reference native Windows sandbox support. The install doc appears stale.
I’m preparing a small PR for the repo-owned fixes (1 and 3). I’m leaving the official-docs-side Homebrew mismatch here for visibility because that change may need to happen outside this repo unless the repo wording is intentionally being updated instead.
2 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
Closing this out because the repo-side fixes are already prepared on a fork branch and the remaining mismatch may need follow-up in the official docs surface rather than this repo issue.