# Remote Tests

> How to run tests using remote executor.

- Skill: `manaflow-ai/remote-tests` (Agent Skill)
- Install (CLI): `npx skillmds@latest add manaflow-ai/remote-tests`
- Raw SKILL.md: https://api.skillmd.com/api/skills/manaflow-ai/remote-tests/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: manaflow-ai (https://skillmd.com/u/manaflow-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/manaflow-ai/remote-tests

---


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.