# Install tofuenv with Homebrew

OpenTofu version manager inspired by tfenv. Version 1.0.7 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:tofuenv
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install tofuenv
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:tofuenv
- **Package manager:** Homebrew
- **Version:** 1.0.7
- **Source summary:** OpenTofu version manager inspired by tfenv
- **Homepage:** <https://tofuutils.github.io/tofuenv/>
- **Repository:** <https://github.com/tofuutils/tofuenv>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- tofuenv (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.0.7
## Project history and usage

tofuenv is an OpenTofu version manager, modeled after tfenv, for installing and selecting tofu versions from the shell.

### Project history

tofuenv belongs to the OpenTofu post-fork tooling wave. OpenTofu itself was created after HashiCorp's 2023 Terraform license change and reached a first stable release on January 10, 2024.

The tofuenv README presents the project as an OpenTofu version manager inspired by tfenv, with support for macOS, Linux, and limited Windows/git-bash testing.

### Adoption history

The README documents installation through Homebrew, the Arch User Repository, and a Puppet module, while the input package facts list Homebrew packaging. This suggests its main adoption path is among shell users who already manage infrastructure tools through package managers and dotfiles.

### How it is used

tofuenv installs explicit OpenTofu versions, latest versions, regex-selected latest versions, and versions inferred from OpenTofu required_version constraints. With no version argument it resolves TOFUENV_TOFU_VERSION first, then .opentofu-version files, then defaults to latest.

The tool also exposes package-nerd knobs such as tofuenv_REMOTE for custom release mirrors, tofuenv_ARCH for architecture selection, tofuenv_CONFIG_DIR for state/config placement, and tofuenv_NETRC_PATH for credentials when accessing a protected remote.

### Why package nerds care

tofuenv is useful in the same niche as rbenv, pyenv, and tfenv: it makes infrastructure repositories self-describing through a checked-in version file and lets contributors switch CLI versions without replacing the system package.

### Timeline

- 2023: OpenTofu was forked after the Terraform license change described in the OpenTofu manifesto.
- 2024-01-10: OpenTofu reached its first stable release.
- Current: tofuenv documents Homebrew, AUR, Puppet, manual clone, .opentofu-version, and environment-variable workflows.

### Related projects

- OpenTofu is the CLI managed by tofuenv.
- tfenv is the Terraform version manager that tofuenv cites as its inspiration.

### Sources

- <https://github.com/tofuutils/tofuenv#readme>
- <https://opentofu.org/blog/opentofu-is-going-ga/>
- <https://opentofu.org/manifesto/>
- <https://tofuutils.github.io/tofuenv>
- source_facts.package-manager


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ./.opentofu-version, ~/.opentofu-version

## Credential files

- Unix: $tofuenv_NETRC_PATH

## Combined YAML source

View the package source record on GitHub. [combined/tofuenv.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tofuenv.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph