Awesome Open Source
Awesome Open Source

asdf Main workflow

Manage multiple runtime versions with a single CLI tool, extendable via plugins - docs at

asdf is a CLI tool that can manage multiple language runtime versions on a per-project basis. It is like gvm, nvm, rbenv & pyenv (and more) all in one! Simply install your language's plugin!

Why use asdf?

  • single CLI for multiple languages
  • consistent commands to manage all your languages
  • single global config keeping defaults in one place
  • single .tool-versions config file per project
  • support for existing config files .node-version, .nvmrc, .ruby-version for easy migration
  • automatically switches runtime versions as you traverse your directories
  • simple plugin system to add support for your language of choice
  • shell completion available for common shells (Bash, Zsh, Fish)


Please head over the documentation site for more information!


See in the repo or the Contributing section on the docs site.

Community & Questions

  • GitHub Issues GitHub Issues: report a bug or raise a feature request to the asdf core team
  • GitHub Discussions GitHub Discussions: our preferred method for community Q&A and interaction
  • StackOverflow Tag StackOverflow Tag: see existing Q&A for asdf. Some of the core team watch this tag in addition to our helpful community

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
ruby (12,331
shell (9,857
nodejs (3,635
cli (1,689
elixir (1,163
erlang (794
version-manager (28

Find Open Source By Browsing 7,000 Topics Across 59 Categories