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-bb03116d
  Component      vpc
  Stack          dev
  Source Type    local
  Source         components/terraform/vpc
  Path           .workdir/terraform/dev-vpc-bb03116d
  Content Hash   a60bbfad57c32f1d7acd08defd9f0bb7
  Created        2025-12-28 15:31:47 EST
  Updated        2025-12-28 15:31:47 EST
  Last Accessed  2025-12-28 15:31:47 EST

Understanding the Output​

The command displays:

  • Name - The workdir directory name, ending in <stack>-<component>-<hash> (the trailing hash keeps two component instances from colliding even when their <stack>-<component> prefixes look the same)
  • Component - The Terraform component name
  • Stack - The stack this workdir belongs to
  • Source Type - The source type (local for local components)
  • Source - Original component location
  • Path - Relative path to the workdir
  • Content Hash - Hash of the workdir contents
  • Created - Timestamp when the workdir was first created
  • Updated - Timestamp of the last update
  • Last Accessed - Timestamp when the workdir was last accessed

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

Related Commands​