Skip to main content

atmos terraform workdir show

Use this command to display detailed information about a specific component's workdir, including its path, metadata, and current state.

atmos terraform workdir show --help

Usage​

atmos terraform workdir show <component> --stack <stack> [flags]

Arguments​

component
The name of the Terraform component whose workdir you want to inspect.

Flags​

-s, --stack
Required. The stack name for the component.

Examples​

Show Workdir Details​

# Show details for the vpc component in the dev stack
atmos terraform workdir show vpc --stack dev

Example output:

✓ Workdir Status

  Name          dev-vpc
  Component     vpc
  Stack         dev
  Source        components/terraform/vpc
  Path          .workdir/terraform/dev-vpc
  Content Hash  abc123def456...
  Created       2025-12-28 15:31:47 EST
  Updated       2025-12-28 15:31:47 EST

Understanding the Output​

The command displays:

  • Name - The workdir name (format: <stack>-<component>)
  • Component - The Terraform component name
  • Stack - The stack this workdir belongs to
  • Source - Original component location
  • Path - Relative path to the workdir
  • Content Hash - Hash of the workdir contents (partially masked for security)
  • Created - Timestamp when the workdir was first created
  • Updated - Timestamp of the last update

Error Handling​

If the workdir doesn't exist, the command will display an error:

$ atmos terraform workdir show vpc --stack dev
Error: workdir not found for component 'vpc' in stack 'dev'

This typically means:

  • The component hasn't been initialized yet (run atmos terraform init)
  • The workdir was cleaned (run atmos terraform init to recreate)
  • The provision.workdir.enabled setting is not enabled for this component