# tuist xcodebuild test

tuist xcodebuild test extends the xcodebuild CLI test action with insights.

## Arguments

### skip-quarantine `Optional`

When passed, the quarantine feature is disabled and tests run regardless of whether they are quarantined on the server.

```bash
tuist xcodebuild test --skip-quarantine
```

### passthrough-xcodebuild-arguments `Optional`

Arguments that will be passed through to the xcodebuild CLI. All arguments are forwarded to xcodebuild. Example: tuist xcodebuild test -scheme MyAppTests -destination 'platform=iOS Simulator,name=iPhone 15' -parallel-testing-enabled YES

```bash
tuist xcodebuild test [passthrough-xcodebuild-arguments]
```

### shard-index `Optional`

The zero-based shard index to execute.

```bash
tuist xcodebuild test --shard-index [shard-index]
```

### shard-archive-path `Optional`

**Environment variable** `TUIST_TEST_SHARD_ARCHIVE_PATH`

Path to a locally managed shard archive. Tuist extracts this archive instead of downloading test products from remote storage.

```bash
tuist xcodebuild test --shard-archive-path [shard-archive-path]
```

### inspect-mode `Optional`

**Environment variable** `TUIST_INSPECT_TEST_MODE`

Inspect mode: 'local' parses the xcresult on this machine, 'remote' uploads it for server-side processing, 'off' skips test analysis entirely (no xcresult parsing, archiving, or upload — the Tests dashboard is not populated). When omitted, defaults to 'remote' for tuist-hosted instances and 'local' for self-hosted ones.

```bash
tuist xcodebuild test --inspect-mode [inspect-mode]
```