terragrunt --filter is generally available for Run Queue targeting
Introduced 2026-01-05 · score 0.93
HOW TO USE IT
For targeted Run Queue discovery or execution, use Terragrunt’s unified `--filter` expressions for paths, files read, and dependency traversal. Use `--filters-file` for newline-delimited filters; a legacy excludes file needs conversion to filter expressions.
terragrunt find --filter '{./<path>}'terragrunt find --filter 'reading=<file>'terragrunt run --all --filters-file <filters.txt> -- <tofu-command>WHY THIS HELPS
Target units or visualize the Run Queue in a Terragrunt repository using unified filter expressions.
BEFORE THIS CHANGE
Use the corresponding queue control flag: `--queue-include-dir`, `--queue-exclude-dir`, `--queue-include-units-reading`, `--units-that-include`, `--queue-include-external-dependencies`, `--queue-excludes-file`, or `--graph`.
REQUIREMENTS AND LIMITATIONS
- Version: v0.97.0
- Availability: The --filter flag is generally available; legacy queue flag aliases will not be removed before Terragrunt 1.0.
- --filter <expression>: Select units/stacks with a filter expression; repeat the flag to combine filters. Path inclusion uses `{./path}`, exclusion uses `!{./path}`, file-read matching uses `reading=<file>`, and graph traversal uses `...` around a target.
- --filters-file <file>: Read filter expressions from a newline-delimited text file; the docs show empty lines and `#` comment lines are ignored.
- reading=<file>: Attribute expression that matches units/stacks that read the named file.
- ...: Graph traversal operator; after a target includes its dependencies, before a target includes its dependents. Both directions are supported by surrounding the target.
- Prerequisite: Terragrunt v0.97.0 or later for the generally available `--filter` flag.
- Prerequisite: Filters files contain newline-delimited expressions; the v0.97.0 release note says a `--queue-excludes-file` file does not directly translate to a `--filters-file` file.
- A file used for `--queue-excludes-file` does not directly translate to a file usable with `--filters-file`.
- Legacy queue flag aliases remain for backwards compatibility and will not emit deprecation warnings.
- Docs conflict: Current docs describe graph expressions as `...<target>` for dependents and `<target>...` for dependencies; this differs from the v0.97.0 release note’s `{./**}...` and `...{.}` examples. Use the release-note mappings for v0.97.0.
FIRST-PARTY EVIDENCE
- https://github.com/gruntwork-io/terragrunt/releases/tag/v0.97.0
- https://docs.terragrunt.com/features/filter/filters-file/
- https://docs.terragrunt.com/features/filter/graph/
Check the installed version and the source before using it. Entry JSON