Skip to main content
Catalog id: codex
Display name: Codex CLI
Requires: codex on PATH
ACP bridge binary: codex-acp next to the gpr binary (usually ~/.local/bin/codex-acp)

​
Setup

  1. Install the Codex CLI so codex resolves in your shell.
  2. Authenticate with codex login or OPENAI_API_KEY.
  3. Install the ACP adapter binary as codex-acp in the same directory as gpr.
  4. Verify:
Codex should show status ready.
  1. Select Codex on the workspace in the app.

​
Launch shape

The daemon runs codex-acp, which bridges ACP to the Codex CLI.

​
Common failures