Codex Harness Bundle

Scion harness configuration for Codex, OpenAI's coding agent CLI.

Install

From a repository checkout:

scion harness-config install harnesses/codex

Or directly from GitHub:

scion harness-config install github.com/GoogleCloudPlatform/scion/tree/main/harnesses/codex

Auth Modes

Mode	Env / File	Notes
api-key (default)	CODEX_API_KEY or OPENAI_API_KEY	Codex key takes precedence
auth-file	~/.codex/auth.json	Codex native auth file

Bundle Layout

codex/
  config.yaml       # Harness configuration (provisioner, capabilities, auth)
  provision.py       # Container-side provisioner (pre-start hook)
  Dockerfile         # Image build (FROM scion-base)
  cloudbuild.yaml    # Cloud Build configuration
  home/
    .bashrc                    # Shell config with scion env sourcing
    .codex/config.toml         # Codex client settings (model, otel, etc.)
    .codex/scion_notify.sh     # Notification hook script

Build the Image

# Local Docker build
docker build --build-arg BASE_IMAGE=scion-base:latest -t scion-codex:latest -f Dockerfile .

# Cloud Build
gcloud builds submit --config cloudbuild.yaml .