terragrunt catalog discovery and filtering with catalog-redesign
Introduced 2026-04-27 · score 0.98
HOW TO USE IT
When using Terragrunt v1.0.3 catalog discovery, enable the `catalog-redesign` experiment and run `terragrunt catalog`; add root `.terragrunt-catalog-ignore` rules to exclude paths. For extra rules, use `--ignore-file <path>` or `TG_IGNORE_FILE`; the docs confirm the command and ignore behavior, but not the experiment requirement at v1.0.3.
terragrunt catalogterragrunt catalog --ignore-file <path>WHY THIS HELPS
Discover modules and templates across a repository and exclude selected paths from the catalog.
REQUIREMENTS AND LIMITATIONS
- Version: v1.0.3
- Availability: The `catalog-redesign` experiment is required.
- --ignore-file <path>: Path to an additional ignore file; its rules are appended after root `.terragrunt-catalog-ignore` rules, and the file must exist.
- TG_IGNORE_FILE: Environment-variable alternative to `--ignore-file`.
- Prerequisite: The docs describe `catalog-redesign` behavior as default in v1.1, with no experiment required; they do not document v1.0.3's experiment prerequisite.
- Ignore patterns are anchored at the repository root, one per line; `#` starts a comment, `!` negates, and the last match wins.
- A lone `*` does not cross `/`; `**` does.
- A directory that qualifies as both a template and a module is classified as a template.
- Docs conflict: Current docs describe default catalog behavior at v1.1, later than the card's v1.0.3; they do not verify its experiment switch or v1.0.3 usage.
FIRST-PARTY EVIDENCE
- https://github.com/gruntwork-io/terragrunt/releases/tag/v1.0.3
- https://docs.terragrunt.com/features/catalog/tui/
Check the installed version and the source before using it. Entry JSON