Module Intelligence

The Module Intelligence view provides visibility into all external Terraform modules used across your organization — which modules are in use, where they come from, how many repositories consume them, and which versions are deployed.


Overview

As organizations grow, module sprawl becomes a real problem: teams adopt modules independently, versions diverge, and nobody has a clear picture of what's actually in use. Module Intelligence solves this by automatically detecting external module references during post-merge processing and aggregating them into a single, searchable inventory.


Module List

The main view displays all detected external modules, sorted by consumer count (most-used first). Each module shows:

ColumnDescription
Source BadgeVisual indicator of the module source type (registry, git, S3, GCS, or HTTP)
Source URLFull module source identifier (truncated if longer than 60 characters)
ConsumersNumber of module references across all repositories
ReposCount of unique repositories using this module
Latest VersionMost recent version detected (v-prefixed)
Last SeenRelative timestamp of the most recent detection

Source Types

Terracotta classifies modules by their source type:

Source TypeDescriptionExample
RegistryTerraform Registry or private registry moduleshashicorp/consul/aws
GitGit repository references (GitHub, GitLab, Bitbucket)git::https://github.com/org/module.git
S3AWS S3 bucket sourcess3::https://s3-eu-west-1.amazonaws.com/bucket/module.zip
GCSGoogle Cloud Storage sourcesgcs::https://www.googleapis.com/storage/v1/modules/module.zip
HTTPGeneric HTTP/HTTPS URLshttps://example.com/module.zip

Search & Filter

  • Text search: Filter by module source name (case-insensitive)
  • Source type filter: Narrow to a specific source type (registry, git, S3, GCS, HTTP)

Filter options are dynamically derived from the modules in your data — only source types that actually appear are shown.


Data Pipeline

Module data is collected automatically during the post-merge processing pipeline:

  1. When a PR is merged, Terracotta parses all .tf files for module blocks
  2. Each module's source attribute is classified by type (registry, git, S3, GCS, HTTP)
  3. Module references are stored in the infrastructure graph with version and consumer metadata
  4. The Module Intelligence view aggregates across all repositories

No additional configuration is required — if you have connected repositories with Terraform modules, data populates automatically after merges.


Agent Voice

The Module Intelligence view includes an AI-generated narrative summarizing your module landscape — highlighting the most-used modules, version spread, and any modules that may need attention (e.g., widely-used modules with no version pinning).


TL;DR

  • Module Intelligence inventories all external Terraform modules across your organization
  • Sorted by consumer count — most-used modules surface first
  • 5 source types: Registry, Git, S3, GCS, HTTP
  • Search by module name and filter by source type
  • Data populates automatically from post-merge processing — no setup required
  • Each module shows consumer count, repo count, latest version, and last seen timestamp