# tuist coverage files

List the coverage of a commit's files, least covered first.

## Arguments

### path `Optional`

The path to the directory containing the Tuist project.

```bash
tuist coverage files --path [path]
tuist coverage files -p [path]
```

### full-handle `Optional`

The full handle of the project (account-handle/project-handle). Defaults to the one in the project's configuration.

```bash
tuist coverage files --full-handle [full-handle]
```

### branch `Optional`

The branch whose latest complete commit to read. Defaults to the project's default branch.

```bash
tuist coverage files --branch [branch]
```

### commit `Optional`

The commit to read. Takes precedence over --branch.

```bash
tuist coverage files --commit [commit]
```

### search `Optional`

Only list files whose path contains this text.

```bash
tuist coverage files --search [search]
```

### sort-by `Optional`

Sort by coverage or path. Defaults to coverage.

```bash
tuist coverage files --sort-by [sort-by]
```

### sort-order `Optional`

Sort ascending (asc) or descending (desc). Defaults to asc.

```bash
tuist coverage files --sort-order [sort-order]
```

### page `Optional`

The page number to fetch (1-indexed).

```bash
tuist coverage files --page [page]
```

### page-size `Optional`

The number of files per page. Defaults to 20.

```bash
tuist coverage files --page-size [page-size]
```

### json `Optional`

The output in JSON format.

```bash
tuist coverage files --json
```