macOS
Homebrewverified ยท 100%
brew install tfcleanlocal Homebrew formula metadata
brew
Install tfclean with Homebrew
Remove applied moved block, import block, etc. Version 0.0.18 via Homebrew; verified 2026-06-14.
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 post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Build metadata lists 1 build dependencies.
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 | cli | global executable |
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-07-08
manager version0.0.18
manager updated2026-06-14
local dataok
upstreamcurrent
latest detectedv0.0.18
https://github.com/takaishi/tfclean
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:tfclean |
|---|---|
| Version | 0.0.18 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/tfclean |
| Homepage | https://github.com/takaishi/tfclean |
| Repository | https://github.com/takaishi/tfclean |
| Upstream docs | https://github.com/takaishi/tfclean#readme |
| License | MIT |
| Source archive | https://github.com/takaishi/tfclean/archive/refs/tags/v0.0.18.tar.gz |
| Last updated | 2026-06-14T15:13:52+02:00 |
| Pulse | updated |
| Build dependencies | go |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | tfclean |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
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
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment