> ## Documentation Index
> Fetch the complete documentation index at: https://porter-mintlify-a87355a5.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# porter cluster

> List clusters and view cluster details including node groups, Kubernetes version, cloud provider configuration, and status using the Porter CLI

`porter cluster` contains commands for viewing and managing clusters.

## Prerequisites

* You've logged in to the Porter CLI after running [porter auth login](/standard/cli/command-reference/porter-auth)
* You're connected to the correct project by running [porter config set-project](/standard/cli/command-reference/porter-config)

***

## `porter cluster list`

List all clusters in the current project. The default output renders a formatted table with the cluster name, provider, region, status, and creation date. Cluster names are hyperlinked to their dashboard page in supported terminals.

**Usage:**

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

**Flags:**

| Flag     | Description                                                                                   |
| -------- | --------------------------------------------------------------------------------------------- |
| `--json` | Print clusters as JSON instead of a table. Useful for piping into tools like `jq` in scripts. |

**Example:**

```bash theme={null}
porter cluster list --json | jq '.[].name'
```

<Tip>
  Use `porter config set-cluster` to switch between clusters after listing them.
</Tip>

***

## Related Commands

* [porter config set-cluster](/standard/cli/command-reference/porter-config) - Set the active cluster
* [porter project list](/standard/cli/command-reference/porter-project) - List available projects