# 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
- **Package manager page:** <https://formulae.brew.sh/formula/tofuenv>
- **Version:** 1.0.7
- **Source summary:** OpenTofu version manager inspired by tfenv
- **Homepage:** <https://tofuutils.github.io/tofuenv/>
- **Repository:** <https://github.com/tofuutils/tofuenv>
- **Upstream docs:** <https://github.com/tofuutils/tofuenv#readme>
- **License:** MIT
- **Source archive:** <https://github.com/tofuutils/tofuenv/archive/refs/tags/v1.0.7.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- tofuenv (cli)
- tofuenv (alias)

## Dependencies

- grep

## Uses from macOS

- jq
- unzip

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.0.7
- Local data: ok
- Upstream repository: https://github.com/tofuutils/tofuenv
- Upstream latest detected: v1.0.7 (current)
- info: No package-manager update timestamp was available.
## 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
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** tofuenv
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Conflicts With:** opentofu, tenv
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## 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.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [grep](https://www.automicvault.com/pkg/brew/grep/) - Runtime dependency declared by Homebrew.
- [anyenv](https://www.automicvault.com/pkg/brew/anyenv/) - Shares av.db curated category or tags: cli, developer-tools, version-manager, version-managers.
- [fvm](https://www.automicvault.com/pkg/brew/fvm/) - Shares av.db curated category or tags: cli, developer-tools, version-manager, version-managers.
- [nodebrew](https://www.automicvault.com/pkg/brew/nodebrew/) - Shares av.db curated category or tags: cli, developer-tools, version-manager, version-managers.
- [nodenv](https://www.automicvault.com/pkg/brew/nodenv/) - Shares av.db curated category or tags: cli, developer-tools, version-manager, version-managers.
- [sbtenv](https://www.automicvault.com/pkg/brew/sbtenv/) - Shares av.db curated category or tags: cli, developer-tools, version-manager, version-managers.
- [jenv](https://www.automicvault.com/pkg/brew/jenv/) - Shares av.db curated category or tags: cli, developer-tools, shell, version-manager.
- [ry](https://www.automicvault.com/pkg/brew/ry/) - Shares av.db curated category or tags: cli, developer-tools, shell, version-manager.
- [tenv](https://www.automicvault.com/pkg/brew/tenv/) - Shares av.db curated category or tags: cli, developer-tools, opentofu, version-manager.
- [tfenv](https://www.automicvault.com/pkg/brew/tfenv/) - Local package facts share a topical domain. Shared terms: cli, code, developer, developer-tools, grep.
- [tgenv](https://www.automicvault.com/pkg/brew/tgenv/) - Local package facts share a topical domain. Shared terms: cli, code, developer, developer-tools, infrastructure.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
