# tuist build list

Lists all builds in a project.

## Arguments

### project `Optional`

**Environment variable** `TUIST_BUILD_LIST_FULL_HANDLE`

The full handle of the project. Must be in the format of account-handle/project-handle.

```bash
tuist build list --project [project]
tuist build list -P [project]
```

### path `Optional`

**Environment variable** `TUIST_BUILD_LIST_PATH`

The path to the directory or a subdirectory of the project.

```bash
tuist build list --path [path]
tuist build list -p [path]
```

### git-branch `Optional`

**Environment variable** `TUIST_BUILD_LIST_GIT_BRANCH`

Filter builds by git branch.

```bash
tuist build list --git-branch [git-branch]
```

### status `Optional`

**Environment variable** `TUIST_BUILD_LIST_STATUS`

Filter builds by status (success or failure).

```bash
tuist build list --status [status]
```

### scheme `Optional`

**Environment variable** `TUIST_BUILD_LIST_SCHEME`

Filter builds by scheme.

```bash
tuist build list --scheme [scheme]
```

### configuration `Optional`

**Environment variable** `TUIST_BUILD_LIST_CONFIGURATION`

Filter builds by configuration.

```bash
tuist build list --configuration [configuration]
```

### tags `Optional`

Filter builds by tags. Returns builds containing ALL specified tags.

```bash
tuist build list --tags [tags]
```

### values `Optional`

Filter builds by custom values (key=value format). Returns builds matching ALL specified values.

```bash
tuist build list --values [values]
```

### page `Optional`

**Environment variable** `TUIST_BUILD_LIST_PAGE`

The page number to fetch (1-indexed).

```bash
tuist build list --page [page]
```

### page-size `Optional`

**Environment variable** `TUIST_BUILD_LIST_PAGE_SIZE`

The number of builds per page. Defaults to 10.

```bash
tuist build list --page-size [page-size]
```

### json `Optional`

**Environment variable** `TUIST_BUILD_LIST_JSON`

The output in JSON format.

```bash
tuist build list --json
```

### no-json `Optional`

**Environment variable** `TUIST_BUILD_LIST_JSON`

The output in JSON format.

```bash
tuist build list --no-json
```