codex-app

The codex-app resource installs the Codex desktop app — OpenAI's "Codex command center" for managing coding agent threads, projects, and worktrees. It is a thin wrapper around the Homebrew cask install; the app shares its login, configuration, and MCP servers with the codex CLI and IDE extension via ~/.codex/config.toml.

This resource is macOS only. The Codex desktop app is also available on Windows via the Microsoft Store, but is not yet available on Linux.

Parameters

This resource has no configurable parameters — it manages installation only.

Example usage

[
  {
    "type": "codex-app",
    "os": ["macOS"]
  }
]

Install the CLI and the desktop app together

[
  {
    "type": "codex",
    "os": ["macOS"]
  },
  {
    "type": "codex-app",
    "os": ["macOS"]
  }
]

Notes

• Installed via brew install --cask codex-app to /Applications/Codex.app.
• The desktop app, CLI, and IDE extension all read and write ~/.codex/config.toml and share the same login session — use the codex resource to manage settings and MCP servers declaratively.