# atmos terraform workspace list

Use this command to list all Terraform workspaces for an Atmos component in a stack.

## Usage

Execute the `terraform workspace list` command like this:

```shell
atmos terraform workspace list <component> -s <stack> [options]
```

This command lists all available Terraform workspaces for the specified component's backend configuration. The current workspace is indicated with an asterisk (`*`).

:::tip
Run `atmos terraform workspace list --help` to see all the available options
:::

## Examples

```shell
# List all workspaces
atmos terraform workspace list vpc -s dev
```

## Arguments

- **`component` (required)**

  Atmos terraform component.

## Flags

- **`--stack` (alias `-s`) (required)**

  Atmos stack.
- **`--dry-run` (optional)**

  Show what would be executed without actually running the command.
  ```shell
  atmos terraform workspace list vpc -s dev --dry-run
  ```
- **`--skip-init` (optional)**

  Skip running `terraform init` before executing the command.
  ```shell
  atmos terraform workspace list vpc -s dev --skip-init
  ```

## See Also

- [`atmos terraform workspace`](/cli/commands/terraform/workspace) - Workspace management overview
- [`atmos terraform workspace select`](/cli/commands/terraform/workspace/select) - Select a workspace
- [`atmos terraform workspace new`](/cli/commands/terraform/workspace/new) - Create a new workspace