otty / apps

All apps/asdf

asdf

asdf is a CLI tool that can manage multiple language runtime versions on a per-project basis.

Runs as asdf|macOS, Linux, Windows|asdf-vm.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

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

· ~/.asdfrc Sync

· ~/.tool-versions Sync

· ~/.asdf/ Exclude

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

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

id = "asdf"

name = "asdf"

homepage = "https://asdf-vm.com"

description = "asdf is a CLI tool that can manage multiple language runtime versions on a per-project basis."

executables = ["asdf"]

[dotfiles]

# https://asdf-vm.com/manage/configuration.html — ASDF_CONFIG_FILE defaults to

# "$HOME/.asdfrc". https://asdf-vm.com/manage/versions.html — "With the

# -u/--home flag `asdf set` writes to the .tool-versions file in your $HOME

# directory".

paths = [

"~/.asdfrc",

"~/.tool-versions",

]

# ASDF_DATA_DIR, "$HOME/.asdf" by default: plugins, shims, downloads and every

# installed runtime.

exclude = ["~/.asdf/"]

secret = []

# Both files are read on every shim resolution.

side_effect = false

# No machine_lines: .asdfrc is plugin behaviour and .tool-versions is the set

# of runtime versions the user wants everywhere — both are preferences that

# should follow the user.

[commands]

format = 1

label = "asdf commands"

description = "Manage plugins and tool versions. Choose a subcommand; uninstall, shim and env commands are left out."

quality = "ai-draft"

base = "fig:asdf"

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

[[commands.source]]

id = "fig"

kind = "completion"

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

license = "MIT"

[[commands.subcommand]]

path = ["install"]

label = "Install a version"

description = "Install a plugin's version, or everything in .tool-versions when both are left empty."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

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

license = "MIT"

[[commands.subcommand.field]]

id = "name"

label = "Plugin name"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "version"

label = "Version"

type = "string"

position = 1

suggestions = [{ value = "latest", label = "latest" }]

sources = ["fig"]

[[commands.subcommand.task]]

id = "install-one"

label = "Install a version"

fields = ["name", "version"]

required = ["name", "version"]

[[commands.subcommand.task]]

id = "install-all"

label = "Install all from .tool-versions"

fields = []

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["name", "version"]

[[commands.subcommand]]

path = ["plugin-add"]

label = "Add a plugin"

description = "Add a plugin from the plugin repository, or from a Git URL."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

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

license = "MIT"

[[commands.subcommand.field]]

id = "name"

label = "Plugin name"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "git_url"

label = "Git URL"

description = "Optional. Omit to use the registered plugin repository."

type = "url"

position = 1

sources = ["fig"]

[[commands.subcommand.task]]

id = "add"

label = "Add plugin"

fields = ["name", "git_url"]

required = ["name"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["name", "git_url"]

[[commands.subcommand]]

path = ["local"]

label = "Set local version"

description = "Write a version to .tool-versions in the current directory."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

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

license = "MIT"

[[commands.subcommand.field]]

id = "name"

label = "Plugin name"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "version"

label = "Version"

type = "string"

position = 1

sources = ["fig"]

[[commands.subcommand.task]]

id = "set"

label = "Set local version"

fields = ["name", "version"]

required = ["name", "version"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["name", "version"]

[[commands.subcommand]]

path = ["global"]

label = "Set global version"

description = "Write a version to the home-directory .tool-versions."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

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

license = "MIT"

[[commands.subcommand.field]]

id = "name"

label = "Plugin name"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "version"

label = "Version"

type = "string"

position = 1

sources = ["fig"]

[[commands.subcommand.task]]

id = "set"

label = "Set global version"

fields = ["name", "version"]

required = ["name", "version"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["name", "version"]

[[commands.subcommand]]

path = ["list"]

label = "List installed versions"

description = "List installed versions of a plugin."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

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

license = "MIT"

[[commands.subcommand.field]]

id = "name"

label = "Plugin name"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.task]]

id = "list"

label = "List versions"

fields = ["name"]

required = ["name"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["name"]

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/asdf. 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.