Skip to content

 Why GitHub? 
 Team
 Enterprise
 Explore 
 Marketplace
 Pricing 

Sign in
Sign up
asdf-vm/asdf Public
  Notifications
  Star 12.2k
  Fork 488


 Code
 Issues93
 Pull requests14
 Discussions
 Actions
 Security
 Insights

 master 
 15 branches 26 tags
Go to file Code

Latest commit
raxod502 fix: Fix plugin-test arg parsing (#1084)
c911f2d2 days ago

Git stats
  1,429 commits

Files
Latest commit message
ci: fix cname copy dir
Update code to use . instead of source
fix: completions for asdf plugin list (#1061)
fix: Correct typo on getting started page (#1086)
fix: Fix plugin-test arg parsing (#1084)
ci: automated release workflow (#987)
fix: Fix plugin-test arg parsing (#1084)
Add .editorconfig file.
chore: add gitattributes file (#783)
Add plugin-list-all command
ci: adopt asdf for internal dev. init WSL test environments ( #956)
chore: rm unused changelog heading (#990)
docs: rewrite using Vuepress (#1000)
Add license file. Thanks to @mosic for reporting
docs: rewrite using Vuepress (#1000)
chore: sec details & update supported version (#825)
Update code to use . instead of source
fix: don't override existing ASDF_DIR (#1008)
fix ballad formatting
Add support for config file.
fix: help text as per new feats in #633 (#991)
ci: automated release workflow (#987)
README.md

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

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)

Documentation
Please head over to the documentation site for more information!
  Getting Started
 All Commands
 All Plugins
 Create a Plugin with our asdf-plugin-template
 asdf GitHub Actions

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

Community & Questions

 FAQ

  GitHub Issues: report a bug or raise a feature request to the asdf core team

  GitHub Discussions: our preferred method for community Q&A and interaction

  StackOverflow Tag: see existing Q&A for asdf. Some of the core team watch this tag in
addition to our helpful community

Ballad of asdf
Once upon a time there was a programming language
There were many versions of it
So people wrote a version manager for it
To switch between versions for projects
Different, old, new.

Then there came more programming languages

So there came more version managers
And many commands for them

I installed a lot of them

I learnt a lot of commands

Then I said, just one more version manager

Which I will write instead

So, there came another version manager

asdf version manager - https://github.com/asdf-vm/asdf

A version manager so extendable

for which anyone can create a plugin
To support their favourite language
No more installing more version managers
Or learning more commands

This was the mail I wrote to a few friends to tell them about the project. Thanks to @roshanvid for
suggesting that this go into the readme

@HashNuke
About

Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more
asdf-vm.com/
Topics
nodejs ruby shell cli erlang elixir version-manager multiple-languages asdf-vm

Resources
 Readme
License
 MIT License
Releases

 26 tags
Packages

No packages published
Contributors 161


 


+ 150 contributors
Languages

 Shell100.0%

 © 2021 GitHub, Inc.

 Terms
 Privacy
 Security
 Status
 Docs

 Contact GitHub
 Pricing
 API
 Training
 Blog
 About