# remote-tests

> Claude/Codex skill by [@openai](https://omgskills.com/library/openai/index.md) · 127k stars · Updated 2026-09-26

Testing against remote executors in integration tests.

## Install

```sh
git clone https://github.com/openai/codex /tmp/codex && ln -s /tmp/codex/.codex/skills/remote-tests ~/.claude/skills/remote-tests
```

## From README

Test Fixtures Individual test cases must opt-in to being run against a remote executor. codexcore Use TestCodexBuilder::buildwithautoenv() to opt-in to remote execution in core integration tests unless the test needs more precise control over its executor. app-server Start the server with TestAppServer::newwithautoenv() unless the test defines its own $CODEXHOME/environments.toml or will define custom environments at runtime. Start threads with TestAppServer::sendthreadstartrequestwithautoenv() if you've created the server with the autoenv approach. Omit ThreadStartParams.environments (leave it as None) when doing so. Test Skips If a test doesn't pass in a particular remote executor configuration you can skip it in just that configuration. Include a string reason for future readers when the selected skip macro supports one. Choose the skip macro by what causes the test to fail: skipiftargetwindows!: Windows target behavior. skipifwineexec!: Wine-exec runner constraints.

## Links

- HTML page: https://omgskills.com/library/openai/codex/remote-tests/
- GitHub: https://github.com/openai/codex
- Author: [@openai](https://omgskills.com/library/openai/index.md)

## More from this repo

- [skill-creator](https://omgskills.com/library/openai/codex/skill-creator/index.md) — Used to create or update a Codex skill with appropriately scoped instructions and any needed supporting resources.
   - [@openai](https://omgskills.com/library/openai/index.md) · 135k stars
- [imagegen](https://omgskills.com/library/openai/codex/imagegen/index.md) — Used to generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos,...
   - [@openai](https://omgskills.com/library/openai/index.md) · 128k stars
- [babysit-pr](https://omgskills.com/library/openai/codex/babysit-pr/index.md) — Babysit a GitHub pull request after creation by continuously polling review comments, CI checks/workflow runs, and...
   - [@openai](https://omgskills.com/library/openai/index.md) · 127k stars