tenv

Spec sheet

Purpose

tenv is a Go version manager for OpenTofu, Terraform, Terragrunt, Terramate, and Atmos.Read 3 Oct 2026 · tofuutils.github.io

Intended users

The project describes the tool as helping developers and DevOps professionals manage versions of supported infrastructure tools.Read 3 Oct 2026 · tofuutils.github.io

Platforms

The project says it works on Linux, macOS, Windows, BSD, and Solaris, and lists installation options for Linux, macOS, and Windows.Read 3 Oct 2026 · tofuutils.github.io

Integrations

The documentation describes GitHub Actions environment-variable support for exposing proxied output and updating the tool path.Read 3 Oct 2026 · tofuutils.github.io

Support

The project directs questions and suggestions to GitHub Issues and the tofuutils Slack community's #tofuutils channel.Read 3 Oct 2026 · tofuutils.github.io

License

The project is distributed under the Apache 2.0 license.Read 3 Oct 2026 · tofuutils.github.io

Concurrency

Install and uninstall operations use lockfiles to prevent conflicts between concurrent tenv instances.Read 3 Oct 2026 · tofuutils.github.io

Docker

A Docker image is available, but the documentation says it is not intended for running tenv in CI pipelines.Read 2 Oct 2026 · tofuutils.github.io

GitHub Actions

When the GITHUB_ACTIONS environment variable is enabled, tenv can write proxied stdout, stderr and exit code to GITHUB_OUTPUT.Read 2 Oct 2026 · tofuutils.github.io

GitHub API integration

A GitHub token can be configured to increase REST API rate limits for downloads from GitHub repositories.Read 2 Oct 2026 · tofuutils.github.io

Go library

tenv can be called as a Go module through the tenvlib wrapper package, which the project says has a Semver compatibility promise.Read 3 Oct 2026 · tofuutils.github.io

HCL detection

It uses an HCL parser to extract required version constraints from OpenTofu, Terraform, and Terragrunt files.Read 3 Oct 2026 · tofuutils.github.io

Installation

Installation options include package managers, manual packaged binaries, and a Docker image; the documentation says Docker is not intended for CI pipelines.Read 3 Oct 2026 · tofuutils.github.io

Interactive use

Running tenv without a subcommand displays interactive menus for managing tools and versions.Read 2 Oct 2026 · tofuutils.github.io

Security checks

It checks SHA-256 checksums and supports signature verification with cosign or PGP for some managed tools.Read 3 Oct 2026 · tofuutils.github.io

Semver

The project states that it is compatible with Semver 2.0.0.Read 3 Oct 2026 · tofuutils.github.io

Verification limits

The documentation says Terragrunt and Atmos releases have checksum checks but no signature available; unstable OpenTofu versions are signed only with cosign.Read 3 Oct 2026 · tofuutils.github.io

Version detection

It uses semantic versioning and can parse HCL files to extract version constraints for OpenTofu, Terraform and Terragrunt.Read 2 Oct 2026 · tofuutils.github.io

Version management

It can install and switch between versions of the supported tools.Read 2 Oct 2026 · tofuutils.github.io

Version selection

It supports exact versions, semantic version constraints, latest or prerelease versions, and versions detected from infrastructure-as-code files.Read 3 Oct 2026 · tofuutils.github.io

Where Specifiction places it

• Runtime Version Managers#27 of 306.8
• Development Environment Managers#48 of 506.8