v3.2.2

3.2.2 (April 28, 2026)

• FIX: Fail fast with precise diagnostics when TFENV_CONFIG_DIR is not writable, instead of misreporting lock contention for 60s; offer interactive fallback to ~/.tfenv (#524)

v3.2.1

3.2.1 (April 28, 2026)

• FIX: Install lock misreads missing config parent dir as contention, blocking first-run installs via Homebrew on macOS (Gavin Elder gavin.elder@seqera.io) — fixes #487 and #525

v3.2.0

What's New in v3.2.0

New Features

• Comments in .terraform-version files — Lines starting with # and inline # comments are now stripped, allowing you to annotate your version files (#391, #283)
• Multi-version uninstall — tfenv uninstall now accepts multiple versions in a single invocation (#449)
• Architecture display in tfenv list — Installed versions now show their binary architecture (e.g. amd64, arm64) (#321)
• tfenv use - — Switch back to the previously active Terraform version, shell-style (#378)

Full changelog: https://github.com/tfutils/tfenv/blob/master/CHANGELOG.md

v3.1.0

tfenv v3.1.0

First release since v3.0.0 (July 2022).

New Features

• latest-allowed version resolution from required_version constraints in Terraform files, supporting =, >=, >, <=, and ~> operators
• TFENV_SKIP_REMOTE_CHECK to skip checking remote versions before installing
• Per-version file locking to prevent concurrent install races (#422)
• Conditional bashlog loading based on shell interactivity via TFENV_BASHLOG (#229)
• Custom remote compatibility for Artifactory and similar mirrors
• Dockerfile for containerised usage and end-to-end testing

Bug Fixes

• Filter pre-release versions from latest resolution; use latest: (with colon) or alphabetic regex to include pre-releases (#375, #204)
• CLI argument takes precedence over TFENV_TERRAFORM_VERSION for install (#441)
• Route tfenv log output to stderr in terraform shim context (#374)
• Do not assume brew is available for GNU grep detection (#442)
• Operator precedence bug and unbound variable in version-name resolution (#406, #431)
• Shell quoting fixes: trap word-splitting (#455), curl paths with spaces (#454), exec argument iteration (#453)
• Stray closing paren in syslog tag (#451), dead code removal (#452, #460)
• Fix realpath not available on macOS
• Fix use of -chdir with absolute paths (#354)
• Handle different line endings in .terraform-version files
• Windows OS selection with underscore handling for Cygwin-like tools
• Darwin arm64/amd64 regex workaround fix
• macOS architecture selection for TFENV_ARCH
• Replace use of rev for Windows compatibility
• Fix latest-allowed version matching for partial versions
• Fix legacy ENV syntax in Dockerfile
• Various documentation fixes and README improvements

Test Coverage

Complete test coverage overhaul — 13 test suites (7 new), zero failures across Ubuntu and macOS:

• commands, list-remote, pin, version-file resolution, pre-release filtering, environment variables, resolve-version

Full Changelog

See CHANGELOG.md for complete details with contributor attribution.

v3.0.0 - Major Update

Main highlights:

• Refactor bashlog
• Fixes for Macs
• Fixes to Auto Install logic and Use logic
• Support for netrc and remote-order-reversal for private mirrors

I'm expecting some more bugs to creep out of the woodwork with these changes. Please report any you find expeditiously and I'll try to get fixes released quickly.

Belated release of master from 2021

Apologies to all for the delays to this release.

This is a release of the state of master following changes in May to August of 2021 with passing tests and due caution that I can't remember what I was holding off on to put this release out at the time. Probably something I wanted to include, but didn't get a chance to go back to including.

A new maintainer has been added to tfenv and I hope to make progress on the outstanding Issues and PRs soon.

Security updates following hcsec-2021-12

Security updates

Emergency fix for hcsec-2021-12

Fixes #259 by merging #257

v2.2.0

2.2.0 (February 06, 2021)

• Convert GitHub CI from Travis CI to Github Actions
• Fix min-required after it was broken by 2.1.0 (#235)
• Min-required recursive lookup was dangerously broken. Removed the recursion that should never have been (#237)
• Fix the failure of tfenv list when no default was set (#236)
• Add init command (#240)
• Use ggrep on Mac with Homebrew (#218)

v2.1.0

Caveat Emptor: Struggling with Travis CI's new credits system. Testing for this release has been best-effort.

• Update tfenv-min-required to search root before recursing (#203)
• Terraform 0.13.0 support (#191)
• Add Arch Linux install instructions via Arch User Repository (AUR) (#201)
• min-required correctly finds tagged release versions (#206)
• install: make keybase a fall-through verification variant (#213)
• Feature/add TFENV_TERRAFORM_VERSION env var (#222)
• Document version-name command (#224)
• Fix signature verification bypass due to insufficient hashsum checking (#212)
• Fix keybase login exit code handling (#188)
• Fix bug on MacOS when using CLICOLOR=1 (#152)
• Improved error handling in tfenv-list-remote-curl (#186)
• Test in Windows (#140)
• force tfenv to write over existing zip if it exists (#169)
• Remove the versions directory when the last version is uninstalled (#128)
• Add support for sha256sum command (#170)
• Adding freebsd support (#133)
• Improve shell script synatx (#174)
• Begrudging Bash 3.x Compatability because of macOS (#181)