# Install codex-acp with Homebrew, Nix Use Codex from ACP-compatible clients such as Zed! Version 0.16.0 via Homebrew; verified 2026-06-22. ## Install ```sh sudo av install brew:codex-acp ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install codex-acp ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#codex-acp ``` Evidence: nixpkgs package indexes: pkgs/by-name/co/codex-acp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:codex-acp - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.16.0 - **Source summary:** Use Codex from ACP-compatible clients such as Zed! - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-22T14:03:03-07:00 - **Generated:** 2026-07-09T07:20:21+00:00 ## Executables - codex-acp (cli) - codex-acp (alias) ## Build dependencies - pkgconf - rust ## Uses from macOS - bzip2 ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-09 - Package-manager version: 0.16.0 - Package-manager updated: 2026-06-22 - Local data: ok - Upstream repository: https://github.com/zed-industries/codex-acp - Upstream latest detected: v0.16.0 (current) ## Project history and usage codex-acp is an adapter that exposes OpenAI Codex through the Agent Client Protocol for ACP-compatible clients such as Zed. ### Project history The Zed Industries README describes the package as an ACP adapter around the Codex CLI. It also states that development is moving to agentclientprotocol/codex-acp, where implementation and maintenance work is being pooled across teams. ### Adoption history The README says current Zed versions can use the adapter out of the box, while other ACP clients can run codex-acp directly or via npm. The supplied package facts list Homebrew and Nix distribution. ### How it is used The adapter is aimed at editor and agent-client integrations rather than general shell scripting. The README lists support for context mentions, images, tool calls with permission requests, edit review, TODO lists, slash commands, client MCP servers, and ChatGPT or API-key authentication methods. ### Why package nerds care For package maintainers, codex-acp is an integration package sitting between a fast-moving AI coding CLI and editor-side protocol clients. Its distribution significance is less about standalone algorithms and more about making Codex installable as a protocol-speaking executable. ### Timeline - README: Development is moving to agentclientprotocol/codex-acp. - README: Zed can use the adapter out of the box, while other ACP clients can run codex-acp directly or via npm. ### Related projects - The README links the adapter to OpenAI Codex, the Agent Client Protocol, Zed external-agent support, and the newer agentclientprotocol/codex-acp repository. ### Sources - ## Security Notes No matching local secret-handling manifest was found for codex-acp. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** codex-acp - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - codex-acp: normalized package name match | nixpkgs package indexes: pkgs/by-name/co/codex-acp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [claude-squad](https://www.automicvault.com/pkg/brew/claude-squad/) - Shares av.db curated category or tags: ai-coding, cli, codex, developer-tools. - [happy-coder](https://www.automicvault.com/pkg/brew/happy-coder/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [claude-cmd](https://www.automicvault.com/pkg/brew/claude-cmd/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [claude-code-router](https://www.automicvault.com/pkg/brew/claude-code-router/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [claude-code-templates](https://www.automicvault.com/pkg/brew/claude-code-templates/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [claude-hooks](https://www.automicvault.com/pkg/brew/claude-hooks/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [claudekit](https://www.automicvault.com/pkg/brew/claudekit/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [cline](https://www.automicvault.com/pkg/brew/cline/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [acpx](https://www.automicvault.com/pkg/npm/acpx/) - Local metadata places this package in an adjacent workflow. Shared terms: acp, agent, agent-client-protocol, cli, client. - [codexui-android](https://www.automicvault.com/pkg/npm/codexui-android/) - Local metadata places this package in an adjacent workflow. Shared terms: ai-coding, cli, client, codex, coding. - [extract-design-system](https://www.automicvault.com/pkg/npm/extract-design-system/) - Local package facts share a topical domain. Shared terms: agent, ai-coding, as, cli, codex. ## Combined YAML source View the package source record on GitHub. [combined/codex-acp.yml](https://github.com/automic-vault/db/blob/main/combined/codex-acp.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - 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