Our take
Activeregular commits and releases- 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 commit | 2026-10-16 (14 days ago) |
|---|---|
| Commits, last 90 days | 14 |
| Releases, last 12 months | 4 (latest v0.20.2, 2026-09-22) |
| Contributors | 100+ (top contributor: 42% of commits) |
| Issues closed, last 90 days | 12 (typically closed in 84 days) |
| Pull requests merged, last 90 days | 18 (typically merged in 0 days) |
| Project age | 11 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.
Stars
25,624Forks
1,047Change 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-versionsfile. - Set global defaults in one configuration.
- Switch runtime versions automatically when traversing project directories.
- Support existing
.nvmrc,.node-versionand.ruby-versionfiles. - 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-versionsfile 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.