# 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. Also installable with nix: nix profile install nixpkgs#codex-acp.

## 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
- **Version:** 0.16.0
- **Source summary:** Use Codex from ACP-compatible clients such as Zed!
- **Homepage:** <https://github.com/zed-industries/codex-acp>
- **Repository:** <https://github.com/zed-industries/codex-acp>
- **Last updated:** 2026-06-22T14:03:03-07:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- codex-acp (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.16.0
## 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

- <https://github.com/zed-industries/codex-acp#readme>


## 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.


## 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


## Combined YAML source

View the package source record on GitHub. [combined/codex-acp.yml](https://github.com/mxcl/pkgdb/blob/main/combined/codex-acp.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph