Skip to content
Codify

asdf-global

Asdf is an all-in-one tool manager designed to replace individual language specific version managers such as pyenv, nvm, rbenv, etc.

The asdf-global resource loads installed tools globally for the user by adding it to the .tool-versions located in the users $HOME directory. In asdf, installed tools must be added to a .tool-versions file for that tool to be available in that directory or any subdirectories. Tools that are not loaded are not available.

See the main page for an overview of the various asdf resources.

Parameters:

  • plugin: (string, required) The name of the asdf plugin. The plugin must already be installed on the system using asdf.plugin or asdf-plugin.

  • version: (array[string], required) The version of the tool to load. The version must already be installed on the system. Install tool versions using the asdf-plugin or asdf-install resources.

Example usage:

Install asdf and load golang:

codify.json
[
  {
    "type":  "asdf"
  },
  {
    "type": "asdf-plugin",
    "plugin": "golang",
    "versions": ["latest"]
  },
  {
    "type": "asdf-global",
    "plugin": "golang",
    "version": "latest"
  }
]

Dependencies:

asdf-global has a hard dependency on asdf being installed on the system already or asdf being in the config.

asdf-global also requires that the plugin and tool version be already installed on the system. Plugins and tools can be installed using asdf-plugin or asdf-install.