# tuist run

Runs a preview or a scheme from a generated project.

## Arguments

### runnable

**Environment variable** `TUIST_RUN_SCHEME`

A preview URL, app name with a specifier such as App@latest or App@feature-branch, or a scheme from a generated project.

```bash
tuist run [runnable]
```

### path `Optional`

The path to the directory that contains the project with the target or scheme to be run.

```bash
tuist run --path [path]
tuist run -p [path]
```

### device `Optional`

The device name to run on.

```bash
tuist run --device [device]
```

### generate `Optional`

**Environment variable** `TUIST_RUN_GENERATE`

Force the generation of the project before running.

```bash
tuist run --generate
```

### no-generate `Optional`

**Environment variable** `TUIST_RUN_GENERATE`

Force the generation of the project before running.

```bash
tuist run --no-generate
```

### clean `Optional`

**Environment variable** `TUIST_RUN_CLEAN`

When passed, it cleans the project before running.

```bash
tuist run --clean
```

### no-clean `Optional`

**Environment variable** `TUIST_RUN_CLEAN`

When passed, it cleans the project before running.

```bash
tuist run --no-clean
```

### configuration `Optional`

The configuration to be used when building the scheme.

```bash
tuist run --configuration [configuration]
tuist run -C [configuration]
```

### os `Optional`

**Environment variable** `TUIST_RUN_OS`

The OS version of the simulator.

```bash
tuist run --os [os]
tuist run -o [os]
```

### rosetta `Optional`

When passed, append arch=x86_64 to the 'destination' to run simulator in a Rosetta mode.

```bash
tuist run --rosetta
```

### arguments `Optional`

**Environment variable** `TUIST_RUN_ARGUMENTS`

Arguments to pass to the application during execution. All arguments after the scheme name are forwarded to the app. Example: tuist run MyApp --verbose --config debug

```bash
tuist run [arguments]
```