# remote-tests

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

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/skills/openai/codex/remote-tests/
- GitHub: https://github.com/openai/codex
- Author: [@openai](https://omgskills.com/library/openai/index.md)

## More from this repo

- [code-breaking-changes](https://omgskills.com/skills/openai/codex/dot-codex/skills/code-review-breaking-changes/index.md) — Breaking changes
   - [@openai](https://omgskills.com/library/openai/index.md) · 123k stars
- [path-types](https://omgskills.com/skills/openai/codex/dot-codex/skills/path-types/index.md) — Choose Rust types for operating system paths across the Codex repository.
   - [@openai](https://omgskills.com/library/openai/index.md) · 114k stars
- [update-v8-version](https://omgskills.com/skills/openai/codex/dot-codex/skills/update-v8-version/index.md) — Used to update Codex's pinned \`v8\` / \`rusty\_v8\` versions, validate the release-candidate path, and investigate failed...
   - [@openai](https://omgskills.com/library/openai/index.md) · 106k stars