> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baseten.co/llms.txt
> Use this file to discover all available pages before exploring further.

# baseten train project cache

> Inspect a training project's cache

## describe

```sh theme={"system"}
baseten train project cache describe [OPTIONS]
```

Describe the files in a training project's shared cache, largest first.

The cache is shared by every job in the project and persists between runs.

### Options

<ParamField body="-q, --jq" type="TEXT">
  Filter JSON output with a jq expression; implies --output json (or jsonl for streamed commands)
</ParamField>

<ParamField body="-o, --output" type="TEXT" default="text">
  Output format

  One of: `text`, `json`, `jsonl`, `none`
</ParamField>

<ParamField body="--profile" type="TEXT">
  Use a specific stored profile for this command, overriding BASETEN\_PROFILE and the current profile
</ParamField>

<ParamField body="--project" type="TEXT" required>
  Training project to describe, by name or ID.
</ParamField>

<ParamField body="--sort" type="TEXT" default="size">
  Sort the listing by 'size' (largest first) or 'path' (alphabetical).

  One of: `size`, `path`
</ParamField>

<ParamField body="-v, --verbose" type="BOOL">
  Enable verbose logging
</ParamField>

### Examples

Describe a project's cache

```sh theme={"system"}
baseten train project cache describe --project my-project
```

Sort the cache listing by path

```sh theme={"system"}
baseten train project cache describe --project my-project --sort path
```

### Filter output with `--jq`

Print the cached file paths

```sh theme={"system"}
baseten train project cache describe --project my-project --jq '.file_summaries[].path'
```

### Output

**Text mode (`--output text`):** A total size line, then a table with columns: PATH, TYPE, SIZE, PERMISSIONS, MODIFIED. When the cache is empty, prints "Cache is empty." to stderr.

**JSON mode (`--output json`):** payload type `managementapi.GetCacheSummaryResponse`.