macOS
Homebrewverified · 100%
brew install tfcleanlocal Homebrew formula metadata
brew / rank 9050
Install tfclean with Homebrew
Remove applied moved block, import block, etc. Version 0.0.19 via Homebrew; verified 2026-07-26.
install
Additional install commands
overview
Package summary
Remove applied moved block, import block, etc
Project links
Commands and aliases
- tfclean
history
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
- https://github.com/takaishi/tfclean/blob/main/CHANGELOG.md
- https://github.com/takaishi/tfclean/blob/main/README.md
security posture
No protected-tool coverage found yet
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.
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
tfclean | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version0.0.19
manager updated2026-07-26
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:tfclean |
|---|---|
| Version | 0.0.19 |
| Package manager | Homebrew |
| Homepage | https://github.com/takaishi/tfclean |
| Repository | https://github.com/takaishi/tfclean |
| Last updated | 2026-07-26T00:50:38+02:00 |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated package history
- pkg.so package database
- pkgdb category and tag curation