codex

OpenAI Codex CLI packaged on the reusable agentimg foundations.

Contents

Images
Use cases
File map
Sources

Images

Variant	Contents	Base	Moving tags	Codex release tag
`ubuntu-browser` (primary)	Codex, Ubuntu tools, headless Chromium	`ghcr.io/hambn/agentimg:ubuntu-browser`	`latest`, `ubuntu-browser`	`codex-v<version>`
`ubuntu`	Codex and Ubuntu tools	`ghcr.io/hambn/agentimg:ubuntu`	`ubuntu`	primary-only tag is not repeated
`alpine-browser`	Codex, Alpine tools, Chromium	`ghcr.io/hambn/agentimg:alpine-browser`	`alpine-browser`	primary-only tag is not repeated
`alpine`	Codex and Alpine tools	`ghcr.io/hambn/agentimg:alpine`	`alpine`	primary-only tag is not repeated

Pull moving tags from ghcr.io/hambn/codex:<tag> or docker.io/hambn/codex:<tag>. A Codex npm release repoints all moving tags and adds codex-v<version> to the primary image. agentimg base refreshes and repository edits repoint moving tags only. See the repository's registry and tag policy.

The deployment examples require OPENAI_API_KEY at runtime; credentials are not baked into the image.

Use cases

Interactive local coding — examples/docker/.
Repeatable local sessions — examples/docker-compose/.
Rootless development — examples/podman/.

File map

text

codex/
├── README.md
├── images/
│   ├── alpine/
│   │   └── Dockerfile
│   ├── alpine-browser/
│   │   └── Dockerfile
│   ├── ubuntu/
│   │   └── Dockerfile
│   └── ubuntu-browser/
│       └── Dockerfile
└── examples/
    ├── docker/
    │   ├── README.md
    │   ├── airgapped.run.sh
    │   └── run.sh
    ├── docker-compose/
    │   ├── README.md
    │   ├── airgapped.docker-compose.yml
    │   └── docker-compose.yml
    └── podman/
        ├── README.md
        └── run.sh

CI is defined in .github/workflows/ai-codex.yml.

Sources