Codex remote-tests

How to run tests using remote executor.

install

source · Clone the upstream repo

git clone https://github.com/openai/codex

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openai/codex "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.codex/skills/remote-tests" ~/.claude/skills/openai-codex-remote-tests && rm -rf "$T"

manifest: .codex/skills/remote-tests/SKILL.md

tags

#testing #docker #remote-execution #devbox #linux

source content

Some codex integration tests support a running against a remote executor. This means that when CODEX_TEST_REMOTE_ENV environment variable is set they will attempt to start an executor process in a docker container CODEX_TEST_REMOTE_ENV points to and use it in tests.

Docker container is built and initialized via ./scripts/test-remote-env.sh

Currently running remote tests is only supported on Linux, so you need to use a devbox to run them

You can list devboxes via

applied_devbox ls

, pick the one with

codex

in the name. Connect to devbox via

ssh <devbox_name>

. Reuse the same checkout of codex in

~/code/codex

. Reset files if needed. Multiple checkouts take longer to build and take up more space. Check whether the SHA and modified files are in sync between remote and local.