minamijoyo/tfmigrate

Health v2 · maintenance only

Adoption not part of the score

1278 stars · 63 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

tfmigrate is a CLI tool for safely migrating Terraform and OpenTofu state files in a GitOps-friendly, declarative way. It lets you write state mv/rm/import operations as HCL migration files, dry-run them, and track applied migration history.

Use cases

• rename or move terraform resources in state without manual terraform state mv commands
• split or merge terraform state files when refactoring a monorepo
• import existing infrastructure into terraform state declaratively
• dry-run state migrations and verify terraform plan shows no changes
• track and apply unapplied state migrations in sequence in CI
• replace state providers across a terraform codebase

When to choose

• you practice GitOps and want state changes committed as reviewable code
• you need to refactor terraform state across multiple tfstates in a monorepo
• you want safe, simulated state migrations before touching remote state

When to avoid

• you only need simple one-off state edits and are comfortable with terraform state commands directly
• you use IaC tools other than Terraform or OpenTofu

Facets

cli-tool · maturity active

infrastructure-as-code cli developer-tools configuration-management infrastructure-as-code developer-tools windows cli go terraform opentofu tfstate gitops state-migration hcl devops automation linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="minamijoyo/tfmigrate")