Skip to main content
Perform operations on Terraform workspaces configured in your Clanker configuration.

​
Usage

clanker terraform <subcommand> [flags]

​
Configuration

Configure Terraform workspaces in ~/.clanker.yaml: 
terraform:
  default_workspace: dev
  workspaces:
    dev:
      path: ~/infrastructure/terraform/dev
      description: Development infrastructure
    staging:
      path: ~/infrastructure/terraform/staging
      description: Staging infrastructure
    prod:
      path: ~/infrastructure/terraform/prod
      description: Production infrastructure
Paths support environment variable expansion and tilde (~) for home directory.

​
Subcommands

​
list

List all Terraform workspaces configured in your Clanker configuration. 
clanker terraform list
Output example: 
Available Terraform Workspaces (default: dev):

  dev (default)
    Path: /home/user/infrastructure/terraform/dev
    Description: Development infrastructure

  staging
    Path: /home/user/infrastructure/terraform/staging
    Description: Staging infrastructure

  prod
    Path: /home/user/infrastructure/terraform/prod
    Description: Production infrastructure

​
Integration with ask command

For AI-powered Terraform queries, use the ask command with the --terraform flag: 
# Query Terraform state
clanker ask --terraform "What resources are in the dev workspace?"

# Check for drift
clanker ask --terraform "Are there any changes between state and actual infrastructure?"

# Get outputs
clanker ask --terraform "What are the outputs from the prod workspace?"

# Plan analysis
clanker ask --terraform "What would happen if I apply this plan?"

​
Combined queries

You can combine Terraform queries with AWS queries to detect drift: 
clanker ask --aws --terraform "Compare actual AWS resources with Terraform state"
See the Terraform integration guide for more details.

​
Terraform operations

While the terraform list command shows configured workspaces, the ask command can perform actual Terraform operations:
  • State queries: Read current Terraform state
  • Plan analysis: Analyze what would change
  • Output retrieval: Get Terraform outputs
  • Drift detection: Compare state with actual infrastructure
Clanker does not execute terraform apply automatically. It only reads state and plans.

​
Workspace selection

When using --terraform, Clanker uses the default workspace unless you specify otherwise in your query: 
# Uses default workspace (dev)
clanker ask --terraform "Show current state"

# Specify workspace in the query
clanker ask --terraform "Show state from prod workspace"

Terraform integration

Learn about Terraform integration

Ask command

Natural language infrastructure queries

Configuration

Configure Terraform workspaces

Multi-environment

Manage multiple environments

Build docs developers (and LLMs) love

Get started for freeTalk to us