asdf
asdf-vm.com
- Free plan
- macOS
- Linux
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`.
Plans
Every plan and priceasdf
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.