asdf

# asdf Version Manager Skill asdf is a universal CLI version manager — one tool to replace nvm, pyenv, rbenv, tfenv, goenv and more. It manages per-project versions via `.tool-versions` files and switches versions automatically as you navigate directories. --- ## When to Use This Skill Use this skill when the user is: - **Installing or setting up asdf** on a new machine (any OS, any shell) - **Adding plugins** for a language or tool (Node.js, Python, Go, Terraform, kubectl, Helm, etc.) - **Installing or switching versions** of any tool managed by asdf - **Managing `.tool-versions` files** — creating, editing, or understanding version resolution - **Migrating from single-language version managers** like nvm, pyenv, rbenv, goenv, tfenv, or sdkman - **Configuring shell integration** for Bash, Zsh, Fish, or Elvish - **Debugging version resolution** — wrong version active, shims not working, `command not found` errors - **Onboarding to a project** that uses `.tool-versions` for reproducible environments - **Setting up CI/CD pipelines** that need deterministic tool versions via asdf - **Configuring `.asdfrc`** for legacy file support, concurrency, or plugin repository settings --- ## Core Concepts - **Plugin**: Adapter for a specific tool (nodejs, python, terraform, kubectl, etc.) - **Tool**: The actual runtime/binary managed (e.g., Node.js 20.11.0) - **.tool-versions**: Project-level file declaring exact versions; asdf resolves it by traversing up the directory tree to `$H...