hambn/codex repository overview

⁠Codex CLI

OpenAI's Codex CLI⁠ 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.

• Source: tools/ai/codex/⁠
• Docs: tool-containers.hgh.dev/docs/ai/codex/⁠

⁠Contents

• Images⁠
• Included software⁠
• Use cases⁠
• Sources⁠

⁠Images

• ubuntu: Ubuntu 24.04 without a browser. latest points 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⁠
• 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⁠
• alpine: Alpine 3.24 without a browser.
  • Base: devbox:alpine-full⁠
  • Tags: alpine
  • Included software: Codex CLI⁠ and the devbox full tier⁠
• alpine-browser: Alpine 3.24 with Chromium.
  • Base: devbox:alpine-browser⁠
  • Tags: alpine-browser
  • Included software: Codex CLI⁠ and the devbox browser tier⁠

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 the Dockerfile⁠

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⁠.

⁠Sources

• Codex repository⁠
• npm package @openai/codex⁠
• Codex documentation⁠