# Install codex with Homebrew Cask OpenAI's coding agent that runs in your terminal. Version 0.146.0 via Homebrew Cask; verified 2026-07-29. Also installable with nix: nix profile install nixpkgs#codex. ## Install ```sh sudo av install cask:codex ``` ## Agent safety answer codex is an AI coding agent application with local file and tool access potential. - **Credential access:** May access repository files, local configs, and credentials exposed to its runtime. - **Remote mutation:** Can ask or drive tools that mutate repositories, packages, and cloud services. - **Publish/artifact risk:** Can generate code, patches, and release commands. - **Recommended control:** Run with scanned worktrees and gate sensitive host tool calls. - **Agent-use guidance:** Limit workspace scope; require approval before commands expose secrets or change remote state. Additional install commands: ### macOS - Homebrew Cask (100%): ```sh brew install --cask codex ``` Evidence: local Homebrew cask metadata ## Package facts - **Package key:** cask:codex - **Package manager:** Homebrew Cask - **Version:** 0.146.0 - **Source summary:** OpenAI's coding agent that runs in your terminal - **Homepage:** - **Last updated:** 2026-07-29T08:14:29-07:00 - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - codex (binary) - codex (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 0.146.0 ## Project history and usage Codex CLI is OpenAI's local coding agent, packaged as a terminal command and distributed through installation scripts, npm, GitHub releases, and Homebrew cask. ### Project history The official README frames Codex CLI as the local-computer member of the Codex product family, distinct from the editor integrations, desktop app experience, and cloud-based Codex Web. The repository also links to OpenAI's Codex documentation, install/build notes, contributing information, and an open-source fund. ### Adoption history Codex is packaged for several install paths in its official README: shell install scripts for Mac, Linux, and Windows, npm as @openai/codex, Homebrew cask as codex, and downloadable release binaries. The supplied cask facts identify the Homebrew package as cask:codex. ### How it is used The package-facing workflow is simple: install the executable, run codex, and authenticate with a ChatGPT plan or API key. Configuration lives under ~/.codex/config.toml, and local authentication state is stored under ~/.codex/auth.json according to the existing curation. ### Why package nerds care For package nerds, Codex is notable because it ships an AI coding agent as a conventional local CLI while also spanning product surfaces: terminal, IDE, desktop app, and cloud. The Homebrew cask packages a fast-moving OpenAI developer tool as a single codex command rather than a traditional library. ### Timeline - README: Codex CLI is documented as a local coding agent from OpenAI. - README: Installation paths include shell scripts, npm, Homebrew cask, and GitHub release binaries. ### Related projects - The README distinguishes Codex CLI from OpenAI's IDE install path, Codex App, and Codex Web, while codex-acp packages Codex for ACP-compatible clients. ### Sources - - ## Security Notes No matching local secret-handling manifest was found for codex. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.codex/config.toml ## Credential files - Unix: ~/.codex/auth.json ## Other Package-Manager Records - Nix - codex: normalized package name match | nixpkgs package indexes: pkgs/by-name/co/codex/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - codex: normalized package name match | MacPorts ports tree: llm/codex/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/codex: normalized package name match | Scoop official bucket manifest trees: bucket/codex.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - OpenAI.Codex: normalized package name match | Windows Package Manager source index: OpenAI.Codex from https://cdn.winget.microsoft.com/cache/source.msix - winget - WalkingWiFi.CodexRateLimitTray: normalized package name match | Windows Package Manager source index: WalkingWiFi.CodexRateLimitTray from https://cdn.winget.microsoft.com/cache/source.msix - winget - jcv8000.Codex: normalized package name match | Windows Package Manager source index: jcv8000.Codex from https://cdn.winget.microsoft.com/cache/source.msix ## Combined YAML source View the package source record on GitHub. [combined/codex.yml](https://github.com/mxcl/pkgdb/blob/main/combined/codex.yml) ## Sources - pkg.so package database - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph - curated agent safety answer