# Install tfclean with Homebrew Remove applied moved block, import block, etc. Version 0.0.19 via Homebrew; verified 2026-07-26. ## Install ```sh sudo av install brew:tfclean ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install tfclean ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:tfclean - **Package manager:** Homebrew - **Version:** 0.0.19 - **Source summary:** Remove applied moved block, import block, etc - **Homepage:** - **Repository:** - **Last updated:** 2026-07-26T00:50:38+02:00 - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - tfclean (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 0.0.19 ## Project history and usage tfclean is a Terraform cleanup CLI that removes applied `moved`, `import`, and `removed` blocks from configuration files. It targets the maintenance phase after refactors or imports have already been applied. ### Project history The repository began in June 2024 with an initial implementation, README, and import-block support. v0.0.1 was tagged on 2024-07-01, and the changelog shows rapid iteration through parsing fixes and support for more Terraform block types. By v0.0.4 the project had support for `removed` blocks and forced removal of all block types. Later releases added flags, pre-commit support, GitHub Action installation, aqua installation docs, S3 backend auto-detection, and parser refactoring. ### Adoption history The README documents installation through the author's Homebrew tap, `go install`, aqua, GitHub Actions, and release binaries. It also includes a GitHub Actions workflow that runs tfclean and opens a pull request when cleanup changes are detected. ### How it is used Users point `tfclean` at a directory of Terraform files to remove all relevant blocks, or pass `--tfstate` so it removes only blocks that have already been applied. With S3 backends, the tool can detect state location from Terraform backend configuration in `.tf` files. ### Why package nerds care tfclean is a package-nerd maintenance tool: it exists because modern Terraform/OpenTofu workflows produce temporary declarative migration blocks that should eventually disappear. Installing it as a CLI or GitHub Action lets teams automate that cleanup without hand-editing HCL. ### Timeline - 2024-06-24: Repository initialized - 2024-06-27: Import-block support commit - 2024-07-01: v0.0.1 release - 2024-08-31: v0.0.4 added removed-block and force-removal work - 2025-07-19: v0.0.10 added GitHub Action support - 2025-11-30: v0.0.15 added S3 backend auto-detection - 2026-05-14: v0.0.18 release ### Related projects - Terraform supplies the configuration files and state model tfclean inspects. - GitHub Actions integration is documented for automated cleanup pull requests. - aqua is documented as a declarative CLI version-manager installation path. ### Sources - Official git tags and commit history from https://github.com/takaishi/tfclean - - ## Security Notes No matching local secret-handling manifest was found for tfclean. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Combined YAML source View the package source record on GitHub. [combined/tfclean.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tfclean.yml) ## Sources - pkg.so package database - Geiger risk classifier - curated package history - pkgdb category and tag curation - cross-ecosystem install command graph