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

# vesslctl cluster & resource-spec

> Discover available clusters, GPU types, and resource configurations.

Use these commands to explore what compute infrastructure is available before creating workspaces or jobs.

## Cluster commands

### cluster list

List all clusters available in your organization. Shows each cluster's slug, display name, region, and available GPU types.

```bash theme={null}
vesslctl cluster list
```

**Example output:**

```text theme={null}
SLUG                  NAME                    REGION        GPUS
betelgeuse-na         VESSL Cloud US West     us-west-2     A100 SXM, L40S, CPU-Only
capella-emea          VESSL Cloud EU North    eu-north-1    H100 SXM, A100 SXM
```

## Resource spec commands

The `resource-spec` command has an alias: `rs` (for example, `vesslctl rs list`).

### resource-spec list

List all resource specifications available in your organization. Shows the slug, GPU type, GPU count, CPU cores, memory, hourly cost, and current availability.

```bash theme={null}
vesslctl resource-spec list
```

| Flag            | Description                                         |
| --------------- | --------------------------------------------------- |
| `--cluster`     | Filter resource specs by cluster slug               |
| `--usable-only` | Show only resource specs available for provisioning |

**Example:**

```bash theme={null}
# List all specs for a specific cluster
vesslctl resource-spec list --cluster betelgeuse-na

# Show only usable specs
vesslctl resource-spec list --usable-only
```

**Example output:**

```text theme={null}
SLUG               NAME             CPU    MEMORY     GPU          COUNT   COST/HR   AVAILABILITY
a100-sxm-1         VESSL A100 SXM   12     80 GiB     A100 SXM     1       $1.55     high
a100-sxm-4         VESSL A100 SXM   48     320 GiB    A100 SXM     4       $6.20     high
h100-sxm-1         VESSL H100 SXM   12     80 GiB     H100 SXM     1       $2.39     low
l40s-1             VESSL L40S       8      48 GiB     L40S         1       $1.80     high
cpu-only           VESSL CPU Only   4      16 GiB     -            -       $0.20     -
```

<Tip>
  Use the slug from `resource-spec list` as the value for the `--resource-spec` flag when creating workspaces or jobs.
</Tip>