asdf-vm

asdf: Manage Language Runtime Versions with One CLI

asdf is a Go-based, extensible version manager for managing multiple language runtimes with one CLI. It selects versions per project from a shared `.tool-versions` file and supports plugins for languages including Ruby, Node.js, Elixir and Erlang.

Stars
25.6k
Forks
1k
Stars, last 30 days
+21
Last commit
14 days ago
Contributors
100+

Our take

Activeregular commits and releases

Health score

62/100

How it is scored
Activity
52
Community
83
Issues
46
Pull requests
67

+21 stars in the last 30 days

  • More contributors than 78% of the projects we track
  • Slower to close issues than 84% of the projects we track

asdf is an actively maintained, extensible option for consolidating runtime version management, with regular commits and releases and contributions from a broad contributor base.

Good fit if

  • You manage multiple language runtimes and want a consistent CLI and per-project configuration.
  • Your workflows can use existing asdf plugins, or your team is prepared to create one for a needed language.
  • You value ongoing maintenance: the project is active, has recent commits and releases, and has more than 100 contributors without its work being concentrated in one person.

Look elsewhere if

  • You need a language or workflow that is not covered by an available plugin and do not want to create or maintain one.
  • You need issues to be resolved quickly; recent issue handling has a relatively long median time to close.
All health signals
Last commit2026-10-16 (14 days ago)
Commits, last 90 days14
Releases, last 12 months4 (latest v0.20.2, 2026-09-22)
Contributors100+ (top contributor: 42% of commits)
Issues closed, last 90 days12 (typically closed in 84 days)
Pull requests merged, last 90 days18 (typically merged in 0 days)
Project age11 years

Checked on 2026-10-31 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

25,624

Forks

1,047

Change since Nov 17, 2026: +1 stars·0 forks

Overview

asdf is a Go-based CLI version manager that brings multiple language runtimes under one tool. Instead of maintaining a separate version manager and command set for each language, developers can install plugins and select runtime versions per project.

A shared .tool-versions file records project versions, and asdf switches versions as you move through directories. It also supports existing files such as .nvmrc, .node-version and .ruby-version, which can help teams migrate from other version managers. Shell completion is available for Bash, Zsh, Fish and Elvish.

Key Features

  • Manage runtime versions for multiple languages through one CLI.
  • Extend language support with plugins.
  • Set project-specific versions in a .tool-versions file.
  • Set global defaults in one configuration.
  • Switch runtime versions automatically when traversing project directories.
  • Support existing .nvmrc, .node-version and .ruby-version files.
  • Provide shell completion for Bash, Zsh, Fish and Elvish.

Use Cases

  • A developer working across Ruby and Node.js projects can use one tool to install and switch between both runtimes.
  • A team can pin required runtime versions in each project’s .tool-versions file to make local setups consistent.
  • Someone moving from tools such as nvm, rbenv or pyenv can use asdf’s support for existing version files while consolidating their workflow.
  • Developers using less common languages can check for an existing plugin or create one to add version management support.

What you need

Detected in the repository

  • Go 1.26.3 or newer (from go.mod)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Start with the Getting Started guide for installation and setup instructions. See the README and documentation for commands, plugins and configuration details.

Considerations

  • Language support depends on plugins, so check whether the runtimes and installation workflows you need are covered before standardizing on asdf.
  • The project has recent commits and releases, but reported issue closure times suggest that resolving a reported problem may take time.
  • The repository is written in Go and its module specifies Go 1.26.3. This matters if you plan to build or contribute to the project; the README points users to the documentation for installation steps.

Found this useful?

Share it with someone who would like asdf.

Comparisons