# Install codex with Homebrew Cask OpenAI's coding agent that runs in your terminal. Version 0.145.0 via Homebrew Cask; verified 2026-07-21. 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 - **Package manager page:** - **Version:** 0.145.0 - **Source summary:** OpenAI's coding agent that runs in your terminal - **Homepage:** - **Repository:** - **Source archive:** - **Last updated:** 2026-07-21T19:05:08Z - **Generated:** 2026-07-25T07:20:51+00:00 ## Executables - codex-aarch64-apple-darwin (binary) - codex (alias) ## Dependencies - ripgrep ## Install behavior - Post-install hook: not defined - Bottle: not available ## Freshness - Page generated: 2026-07-25 - Package-manager version: 0.145.0 - Package-manager updated: 2026-07-21 - Local data: ok - Upstream repository: https://github.com/openai/codex - info: No cached GitHub release or tag data was available. ## 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 ## Source Database Details - **Source Database:** Homebrew cask API - **Tap:** homebrew/cask - **Full Token:** codex - **Names:** Codex - **Depends On:** Formula: ripgrep - **Artifacts:** Binary: 1, Generate Completions From Executable: 1, Target: 1, Zap: 1 - **Deprecated:** no - **Disabled:** no ## 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 ## Related links - [Homebrew Cask packages](https://www.automicvault.com/pkg/homebrew-cask-packages/) - Generated from Homebrew Cask package-manager metadata. - [Homebrew Cask binaries](https://www.automicvault.com/pkg/homebrew-cask-binaries/) - Cask artifact metadata includes a binary. - [codex](https://www.automicvault.com/pkg/npm/codex/) - Same normalized package name exists in another local package ecosystem. ## Combined YAML source View the package source record on GitHub. [combined/codex.yml](https://github.com/automic-vault/db/blob/main/combined/codex.yml) ## Sources - Nucleus package database - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph - curated agent safety answer