Terragrunt Navigator

VS Code extension that makes source and config_path paths in Terragrunt HCL files Ctrl+Click navigable.

Features

• Resolves ${get_repo_root()} to the actual git repository root
• Handles Terragrunt's // double-slash convention
• Navigates config_path in dependency blocks to the target terragrunt.hcl
• Navigates find_in_parent_folders("filename") to the resolved parent file
• Resolves dynamic interpolations (e.g. ${local.*}) via terragrunt render --json on click
• Caches render results with hash-based invalidation — repeated clicks are near-instant
• Skips remote sources (git::, s3::, https://, etc.)
• Ignores commented-out lines

Examples

Static source path

terraform {
  source = "${get_repo_root()}/modules/vpc///."
}

Ctrl+Click navigates to modules/vpc/main.tf.

Dependency with static config_path

dependency "vpc" {
  config_path = "${get_repo_root()}/tg/vpc"
}

Ctrl+Click navigates to tg/vpc/terragrunt.hcl.

Dependency with dynamic config_path

locals {
  path = read_terragrunt_config(find_in_parent_folders("path_vars.hcl")).locals
}

dependency "network" {
  config_path = "${get_repo_root()}/infra/gcp-${local.path.gcp_project_id}-${local.path.gcp_region}/network"
}

Ctrl+Click runs terragrunt render --json to resolve the interpolations, then navigates to the resolved terragrunt.hcl.

Parent config includes

locals {
  path = read_terragrunt_config(find_in_parent_folders("path_vars.hcl")).locals
}

Ctrl+Click on path_vars.hcl navigates to the file found by searching parent directories.

Supported patterns

Development

npm install
npm run compile
npm run test:unit