otty / apps

All apps/tfenv

tfenv

Terraform version manager inspired by rbenv.

Runs as tfenv|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

tfenv in your home directory Every rule on this page, by file

· ~/.terraform-version Sync

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/tfenv/otty.tomlThe file this page is generated from

id = "tfenv"

name = "tfenv"

homepage = "https://github.com/tfutils/tfenv"

description = "Terraform version manager inspired by rbenv."

executables = ["tfenv"]

[dotfiles]

# README, ".terraform-version file": "If you put a .terraform-version file on

# your project root, or in your home directory, tfenv detects it and uses the

# version written in it." lib/tfenv-version-file.sh does exactly that —

# `find_local_version_file "${TFENV_DIR:-${PWD}}"` first, then

# `find_local_version_file "${HOME:-/}"`, each walking up looking for

# .terraform-version. The one in a project root belongs to that repository;

# the one in the home directory is the user's default.

paths = ["~/.terraform-version"]

# The other version file, ${TFENV_CONFIG_DIR}/version, is not listed because

# it is not home-relative: lib/helpers.sh sets TFENV_CONFIG_DIR to TFENV_ROOT,

# and bin/tfenv derives TFENV_ROOT from where the script itself lives — so it

# is ~/.tfenv only for the README's `git clone … ~/.tfenv` install and sits

# under the Cellar for a Homebrew one. There is no fixed spelling for it to

# name, and nothing else tfenv writes under the home directory.

exclude = []

secret = []

# One line naming a Terraform version, read once per invocation by a shell

# script; nothing holds it open.

side_effect = false

# No machine_lines: the file holds a single version string, and wanting the

# same Terraform everywhere is why the user wrote it. A machine that does not

# have that version installed will fetch it — TFENV_AUTO_INSTALL defaults to

# true.

[commands]

format = 1

label = "tfenv versions"

description = "Install and switch Terraform versions."

quality = "ai-draft"

base = "fig:tfenv"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/tfenv.ts"

license = "MIT"

[[commands.subcommand]]

path = ["install"]

label = "Install version"

description = "Install a Terraform version (latest, min-required or a number)."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/tfenv.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "version"

label = "Version"

type = "string"

position = 0

suggestions = [{ value = "latest", label = "Latest" }, { value = "min-required", label = "Minimum required by config" }]

sources = ["fig"]

[[commands.subcommand.task]]

id = "install"

label = "Install"

fields = ["version"]

required = ["version"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["version"]

[[commands.subcommand]]

path = ["use"]

label = "Use version"

description = "Switch to an installed version."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/tfenv.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "version"

label = "Version"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.task]]

id = "use"

label = "Use"

fields = ["version"]

required = ["version"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["version"]

[[commands.subcommand]]

path = ["uninstall"]

label = "Uninstall version"

description = "Uninstall a version."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/tfenv.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "version"

label = "Version"

type = "string"

position = 0

effect = "delete"

sources = ["fig"]

[[commands.subcommand.task]]

id = "uninstall"

label = "Uninstall"

fields = ["version"]

required = ["version"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["version"]

[[commands.subcommand]]

path = ["list"]

label = "List installed"

description = "List installed versions."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/tfenv.ts"

license = "MIT"

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = []

[[commands.subcommand]]

path = ["list-remote"]

label = "List installable"

description = "List installable versions."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/tfenv.ts"

license = "MIT"

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = []

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/tfenv. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.