Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

asdf

asdf-vm.com

  • Free plan
  • macOS
  • Linux
7.0 Club score Visit asdf-vm.com

What asdf is

asdf is a free, open-source tool version manager for Linux and macOS. It gives project teams one command interface and a shared `.tool-versions` file for managing versions of multiple tools and runtimes. Plugins let it manage tools such as Node.js, Ruby, and Elixir, while its plugin API can add support for others. When a tool runs, asdf searches for `.tool-versions` beginning in the current directory and moving toward the home directory; shims launch the selected version. Per-plugin support can also use existing files such as `.ruby-version`, `.nvmrc`, and `.node-version`. Listed shell support includes Bash, ZSH, Fish, and Elvish, with completions available. A GitHub Action can use `.tool-versions` in CI/CD workflows. Installation options include Homebrew, Zypper, Pacman, precompiled binaries, Go, or a source build. asdf manages tool versions rather than system packages or upstream dependencies. If no version is listed for a tool, running it produces an error unless that tool is set to `system`.

Who it suits

It suits developers and project teams on Linux or macOS who want a shared way to select tool and runtime versions. Teams needing system package management or upstream dependency management will need something else.

Good to know, and what to watch

  • One configuration file can specify multiple tool versions.
  • Plugins cover Node.js, Ruby, Elixir, and more.
  • Can use several existing version-file formats.
  • Lists four supported shells and a CI/CD GitHub Action.
  • Free and open source.
  • Available for Linux and macOS.
  • Does not manage system packages or upstream dependencies.
  • An unset tool version errors unless set to `system`.

asdf

Free

Open source

The verdict

asdf centralizes tool version selection in a shared project file, with plugins and shell support for developer workflows. It is specifically a tool version manager, not a system package or upstream dependency manager.

What the maker publishes

CI integration
The homepage says asdf provides a GitHub Action to use `.tool-versions` in CI/CD workflows. source
Execution
asdf creates shims for installed executables so it can run the version specified for the current project. source
Installation
The getting-started guide describes installation through Homebrew, Zypper, Pacman, precompiled binaries, Go, or a source build. source
Intended users
The documentation describes using a shared `.tool-versions` file to help project teams use the same tool versions. source
Limits
asdf is a tool version manager, not a system package manager, and it does not manage upstream dependencies. source
Migration
asdf supports existing version files such as `.ruby-version`, `.nvmrc`, and `.node-version` on a per-plugin basis. source
Plugins
Plugins let asdf manage tools such as Node.js, Ruby, and Elixir, and the plugin API allows support for more tools. source
Purpose
asdf is a tool version manager that uses one `.tool-versions` file to share exact tool versions with a project team. source
Security and trust
The official pages opened for this research did not state security certifications or compliance claims. source
Shell support
The homepage lists Bash, ZSH, Fish, and Elvish support with completions available. source
Supported operating systems
The installation guide lists Linux and macOS dependency instructions and provides binaries for operating-system and architecture combinations. source
Unified interface
asdf provides one command interface and configuration file for managing multiple tools and runtimes. source
Version resolution limit
If no version is listed for a tool, executing that tool produces an error unless its version is set to `system`. source
Version selection
asdf selects a tool version from `.tool-versions` files starting in the current directory and searching up toward the home directory. source

Checked against the maker's pages on 4 Oct 2026.