zed-industries/codex-acp
1
0
Fork 0
mirror of https://github.com/zed-industries/codex-acp.git synced 2026-02-27 14:25:29 +01:00
Code Issues Projects Packages Wiki Activity
No description
237 commits 3 branches 52 tags 1.4 MiB
  • Rust 91.3%
  • Shell 4.4%
  • JavaScript 2.5%
  • PowerShell 1.8%
Find a file
Exact
Ben Brandt e979e7c43f
 0.9.5 npm
2026-02-27 12:09:02 +01:00
.github Update to latest codex main (e5e40e2) (#153) 2026-02-16 16:13:30 +01:00
npm 0.9.5 npm 2026-02-27 12:09:02 +01:00
script Notarize binary on macOS (#103) 2025-12-02 11:54:07 +01:00
src Update to latest codex main (e6cd75a) (#170) 2026-02-27 12:07:49 +01:00
.gitignore Code sign binary (#98) 2025-12-01 18:52:15 +01:00
Cargo.lock 0.9.5 2026-02-27 12:08:28 +01:00
Cargo.toml 0.9.5 2026-02-27 12:08:28 +01:00
LICENSE Add license and readme (#10) 2025-10-03 22:11:04 +02:00
README.md Link out to acp website for supported clients 2025-12-30 22:33:45 +01:00
rust-toolchain.toml 0.7.2 2025-12-15 11:54:28 +01:00

README.md

ACP adapter for Codex

Use Codex from ACP-compatible clients such as Zed!

This tool implements an ACP adapter around the Codex CLI, supporting:

  • Context @-mentions
  • Images
  • Tool calls (with permission requests)
  • Following
  • Edit review
  • TODO lists
  • Slash commands:
    • /review (with optional instructions)
    • /review-branch
    • /review-commit
    • /init
    • /compact
    • /logout
    • Custom Prompts
  • Client MCP servers
  • Auth Methods:
    • ChatGPT subscription (requires paid subscription and doesn't work in remote projects)
    • CODEX_API_KEY
    • OPENAI_API_KEY

Learn more about the Agent Client Protocol.

How to use

Zed

The latest version of Zed can already use this adapter out of the box.

To use Codex, open the Agent Panel and click "New Codex Thread" from the + button menu in the top-right.

Read the docs on External Agent support.

Other clients

Or try it with any of the other ACP compatible clients!

Installation

Install the adapter from the latest release for your architecture and OS: https://github.com/zed-industries/codex-acp/releases

You can then use codex-acp as a regular ACP agent:

OPENAI_API_KEY=sk-... codex-acp

Or via npm:

npx @zed-industries/codex-acp

License

Apache-2.0