# pw environments ls

> Source: https://parallelworks.com/docs/cli/pw/environments/ls

## pw environments ls

List compute environments

### Synopsis

The **pw environments ls** command lists compute environments.

Without **--cluster** it lists the environments on every active cluster you can
see, with a cluster column. Clusters that cannot be queried are skipped, so one
unreachable cluster does not hide the rest.

Pass **--cluster** to list one cluster, given as **pw://user/cluster** for a
cluster owned by another user or as **cluster** for one of your own.

```
pw environments ls [flags]
```

### Examples

```
  # List the environments on every active cluster
  pw environments ls
  
  # List the environments on one of your clusters
  pw environments ls --cluster my-hpc
  
  # List the environments on another user's cluster
  pw environments ls --cluster pw://Jake.Thayne/my-hpc
  
  # List only active environments
  pw environments ls --status active
  
  # List as JSON
  pw environments ls -o json
```

### Options

```
      --cluster string   Cluster to list environments on (default: every active cluster)
  -h, --help             help for ls
  -o, --output string    Output format (table, json, list) (default "table")
      --status string    Filter environments by status (active, inactive)
```

### Options inherited from parent commands

```
      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Will override any other platform host settings.
  -v, --verbose                Enable verbose logging
```

### SEE ALSO

* [pw environments](/docs/cli/pw/environments)	 - Manage compute environments