Codex CLI
OpenAI's Codex CLI (opens in new tab) on the devbox
development image, for running Codex on a local checkout or reviewing changes in CI. The
entrypoint is codex, and the container starts in /workspace as sysadmin
(UID 1000). No credentials are stored in the image.
- Images
- GHCR
ghcr.io/hambn/codex - Docker Hub
docker.io/hambn/codex
- GHCR
On this page
Images
ubuntu: Ubuntu 24.04 without a browser.latestpoints here, and the CI recipes use it.- Base:
devbox:ubuntu-full - Tags:
ubuntu,latest,codex-<version> - Included software: Codex CLI and the devbox full tier
- Base:
ubuntu-browser: Ubuntu 24.04 with headless Chromium, the default in the local recipes.- Base:
devbox:ubuntu-browser - Tags:
ubuntu-browser - Included software: Codex CLI and the devbox browser tier
- Base:
alpine: Alpine 3.24 without a browser.- Base:
devbox:alpine-full - Tags:
alpine - Included software: Codex CLI and the devbox full tier
- Base:
alpine-browser: Alpine 3.24 with Chromium.- Base:
devbox:alpine-browser - Tags:
alpine-browser - Included software: Codex CLI and the devbox browser tier
- Base:
Pull ghcr.io/hambn/codex:<tag> or docker.io/hambn/codex:<tag>. codex-<version>
names the Codex npm release in the current ubuntu build. All tags move when the image
is rebuilt; pin a digest to keep one build.
Included software
- Codex CLI
- Command:
codex - Source: npm package
@openai/codex, version pinned in theDockerfile(opens in new tab)
- Command:
Git, Node.js, Python, Go, the Docker CLI, and the other devbox tools come from the
devbox full tier. The *-browser variants add the
browser tier.
Use cases
- Interactive coding on a local checkout with Docker, including hosts that load the image from a saved tar.
- Repeatable local sessions with Docker Compose, with an air-gapped Compose file.
- Rootless sessions on a workstation with Podman.
- Code review in CI on GitHub pull requests with GitHub Actions or on GitLab merge requests with GitLab CI.