ddev-assistant-codex

DDEV add-on for running the @openai/codex CLI inside DDEV web containers.

Installation

ddev add-ons install ddev-assistant-codex

What This Addon Does

• Installs @openai/codex into the container at /usr/local/bin/codex
• Makes codex available on $PATH for ddev ssh and ddev exec
• Mirrors host Codex config into a writable container runtime directory on start

Quick Start

After installation, verify the setup:

ddev exec codex --version

Configuration

Codex Credentials And Runtime Config

The add-on mounts your host ~/.codex directory into the web container as a read-only seed at ~/.cred-seed/codex. During every container startup, that seed is mirrored into the writable runtime config directory at ~/.codex.

Your host config is authoritative. Container-only changes under ~/.codex are removed on restart, then replaced with a fresh copy of the host seed. Configure Codex features such as MCP servers on the host; this add-on mirrors the resulting host ~/.codex config into the DDEV container.

Troubleshooting

Codex CLI not found

ddev restart
ddev exec which codex

Documentation

• @openai/codex
• DDEV Addons