remote-tests

star 91.6k

How to run tests using remote executor.

openai By openai schedule Updated 6/16/2026

name: remote-tests description: How to run tests using remote executor.

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.

Install via CLI
npx skills add https://github.com/openai/codex --skill remote-tests
Repository Details
star Stars 91,617
call_split Forks 13,533
navigation Branch main
article Path SKILL.md
More from Creator