Skip to main content

atmos terraform workdir list

Use this command to list all existing workdirs in your project. The output includes metadata about each workdir such as the component name, stack, source type, and timestamps.

atmos terraform workdir list --help

Usage​

atmos terraform workdir list [flags]

Flags​

--format
Output format: table, json, or yaml. Defaults to table.

Examples​

List All Workdirs​

# List all workdirs in table format (default)
atmos terraform workdir list

Example output:

WORKDIR              COMPONENT    STACK    SOURCE    CREATED              UPDATED
dev-vpc              vpc          dev      local     2024-01-15 10:30:00  2024-01-15 10:30:00
staging-vpc          vpc          staging  local     2024-01-15 11:00:00  2024-01-15 11:00:00
prod-vpc             vpc          prod     local     2024-01-15 12:00:00  2024-01-15 12:00:00
dev-s3-bucket        s3-bucket    dev      local     2024-01-15 10:35:00  2024-01-15 10:35:00

Output as JSON​

# List workdirs in JSON format for scripting
atmos terraform workdir list --format json

Example output:

[
  {
    "name": "dev-vpc",
    "component": "vpc",
    "stack": "dev",
    "source_type": "local",
    "source": "components/terraform/vpc",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z",
    "content_hash": "abc123"
  }
]

Output as YAML​

# List workdirs in YAML format
atmos terraform workdir list --format yaml

Understanding the Output​

Each workdir entry includes:

  • WORKDIR - The workdir directory name (format: <stack>-<component>)
  • COMPONENT - The Terraform component name
  • STACK - The stack name where this workdir is used
  • SOURCE - The source type (local for local components)
  • CREATED - When the workdir was first created
  • UPDATED - When the workdir was last updated