Master Runtime Versions with ASDF 🚀

Swap the pile of nvm, pyenv, jenv, and sdkman for ASDF — a single plugin-powered CLI that installs any runtime, respects legacy files, and locks exact versions in one shareable .tool-versions file so your projects run the same everywhere 🚀

A quick scene 🎬

Friday night. You jump between a legacy Java app, a bleeding-edge React repo, and a dusty Python 2 script. Each project yells for its own version manager — nvm, pyenv, sdkman.

Tabs multiply. Shell profiles bloat. You lose track of which tool owns your $PATH.

Sound familiar? You’re not alone.

The lightbulb moment 💡

You hear about ASDF. One binary. A plugin system. A single file called .tool-versions.

Curious, you run asdf — version It prints v0.16.7 (released Mar 27 2025). Done — no extra setup script, because ASDF was rewritten in Go and now runs 2×-7× faster than the old Bash version.

You think, “Could this replace the pile of managers on my machine?”

Core ideas in 30 seconds ⏱️

• Plugins on demand — install only the runtimes you need.
• .tool-versions — pin every runtime and version in one file, commit it, share it.
• Legacy support — flip legacy_version_file = yes in .asdfrc and ASDF will read .nvmrc, .python-version, .ruby-version, etc.
• Single binary — fast startup, easy upgrades.

Install ASDF in two commands 🛠️

macOS 🍏

brew install asdf
echo '. /opt/homebrew/opt/asdf/libexec/asdf.sh' >> ~/.zshrc
source ~/.zshrc

Linux 🐧

git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.16.7
echo '. $HOME/.asdf/asdf.sh' >> ~/.bashrc
source ~/.bashrc

Configure .asdfrc ⚙️

legacy_version_file = yes
# optional:
# plugins_repo = https://github.com/asdf-vm/asdf-plugins.git

Now, ASDF respects any old project files your team already uses.

Add a few plugins 🎯

asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git
asdf plugin add python https://github.com/danhper/asdf-python.git
asdf plugin add java https://github.com/halcyon/asdf-java.git
asdf plugin add terraform https://github.com/asdf-community/asdf-hashicorp.git
asdf plugin add kubectl https://github.com/asdf-community/asdf-kubectl.git
asdf plugin add awscli https://github.com/MetricMike/asdf-awscli.git
asdf plugin add gcloud https://github.com/jthegedus/asdf-gcloud.git
asdf plugin add azcli https://github.com/mutemutsa/asdf-azcli.git

# Install runtimes:
asdf install nodejs 20.12.0
asdf install python 3.12.1
asdf install java temurin-21.0.2+13

Migrate to a new machine in minutes 🚚

1. Copy .asdfrc and .tool-versions.
2. Install ASDF as above.
3. Run asdf plugin-update — all, then asdf install.

That’s it — your full environment is live.

A skeptic’s pause 🧐

• Do you only code in JavaScript?
• You might prefer Volta, a Node-specific manager with global shims.
• Need zero-config installs for every new dev?
• Tools like mise offer a similar goal with their own takes on UX.
• Worried about one tool failing and blocking your day?
• Keep NVM or Pyenv installed for a while. Switch back only if you hit a blocker.

Try ASDF for a week. Track whether it truly cuts friction or just shifts it. Measure, don’t guess.

Ready to ditch the version-manager zoo? 🦁

Clone the repo, write your .tool-versions, and run your projects without the constant “which runtime am I on?” anxiety.

Your future self — and your teammates — will breathe easier.