# Install tfmv with Homebrew, MacPorts

CLI to rename Terraform resources and generate moved blocks. Version 1.0.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:tfmv
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install tfmv
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install tfmv
```

  Evidence: MacPorts ports tree: sysutils/tfmv/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:tfmv
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/tfmv>
- **Version:** 1.0.0
- **Source summary:** CLI to rename Terraform resources and generate moved blocks
- **Homepage:** <https://github.com/suzuki-shunsuke/tfmv>
- **Repository:** <https://github.com/suzuki-shunsuke/tfmv>
- **Upstream docs:** <https://github.com/suzuki-shunsuke/tfmv#readme>
- **License:** MIT
- **Source archive:** <https://github.com/suzuki-shunsuke/tfmv/archive/refs/tags/v1.0.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- tfmv (cli)
- tfmv (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.0.0
- Local data: ok
- Upstream repository: https://github.com/suzuki-shunsuke/tfmv
- Upstream latest detected: v1.0.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

tfmv is a Terraform refactoring CLI by suzuki-shunsuke for renaming resources, data sources, and modules while generating Terraform moved blocks. Its README frames the tool around the practical problem of changing Terraform block names without losing state continuity.

### Project history

The project emerged in the Terraform 1.x era after moved blocks became the standard way to record address changes in configuration. The README demonstrates a focused workflow: scan Terraform files, rename matching block labels, update references, and emit moved blocks, with no need to run terraform init for the shown rename operation.

### Adoption history

Adoption appears specialized rather than broad: Homebrew lists tfmv as a bottled formula at version 1.0.0 and reports low-volume installs. That pattern fits a maintenance utility used when teams perform Terraform module or naming cleanups rather than a daily Terraform wrapper.

### How it is used

tfmv is used from a Terraform working tree with replacement rules, regular expressions, or Jsonnet-driven rename logic. The README shows examples such as replacing hyphens with underscores, filtering addresses with include/exclude regular expressions, writing moved blocks to moved.tf or another file, and recursively scanning Terraform files while ignoring directories such as .git and .terraform.

### Why package nerds care

For package-manager users, tfmv is a small example of the Terraform ecosystem spawning single-purpose CLIs around state-safe refactoring. Its Homebrew and MacPorts packaging make it convenient for infrastructure engineers who want a one-command tool during large address-renaming migrations.

### Timeline

- 2025: GitHub tags list v0.2.8 in July and v1.0.0 in December.
- 2026: Homebrew formula metadata lists stable version 1.0.0 with bottled builds.

### Related projects

- Terraform moved blocks
- Terraform CLI
- Jsonnet

### Sources

- <https://formulae.brew.sh/api/formula/tfmv.json>
- <https://github.com/suzuki-shunsuke/tfmv#readme>
- <https://github.com/suzuki-shunsuke/tfmv/tags>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** tfmv
- **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:** head, stable

## Other Package-Manager Records

- MacPorts - tfmv: normalized package name match | MacPorts ports tree: sysutils/tfmv/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [tfautomv](https://www.automicvault.com/pkg/brew/tfautomv/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure-as-code, moved-blocks, refactoring.
- [tfenv](https://www.automicvault.com/pkg/brew/tfenv/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure, infrastructure-as-code, terraform.
- [tfmcp](https://www.automicvault.com/pkg/brew/tfmcp/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure, infrastructure-as-code, terraform.
- [tfmigrate](https://www.automicvault.com/pkg/brew/tfmigrate/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure, infrastructure-as-code, terraform.
- [tfocus](https://www.automicvault.com/pkg/brew/tfocus/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure, infrastructure-as-code, terraform.
- [tfplugingen-openapi](https://www.automicvault.com/pkg/brew/tfplugingen-openapi/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure, infrastructure-as-code, terraform.
- [tfproviderlint](https://www.automicvault.com/pkg/brew/tfproviderlint/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure, infrastructure-as-code, terraform.
- [tfclean](https://www.automicvault.com/pkg/brew/tfclean/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure-as-code, moved-blocks, terraform.

## Combined YAML source

View the package source record on GitHub. [combined/tfmv.yml](https://github.com/automic-vault/db/blob/main/combined/tfmv.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
