> ## Documentation Index
> Fetch the complete documentation index at: https://getpullrequest.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Use Codex CLI as an ACP coding agent with GPR.

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:

```bash theme={null}
gpr discover
```

Codex should show status `ready`.

5. Select **Codex** on the workspace in the app.

## Launch shape

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

## Common failures

| Symptom         | Check                                                                                                                   |
| --------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `not installed` | `which codex`                                                                                                           |
| `needs adapter` | `ls "$(dirname "$(which gpr)")/codex-acp"`                                                                              |
| Auth errors     | `codex login`, or `OPENAI_API_KEY` on the Codex process via [agents.json](/docs/reference/agents-json) (not only your shell) |
| Stale PATH      | `gpr restart` after installing tools                                                                                    |