NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #106 by repository stars
Latest stable
v0.20.2
Last release 10 days ago
11 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 52 of 54 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
140 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add a newline delimiter when suggesting versions to install
Your coding agent can read these notes before it upgrades. Set up the MCP server →
correct formatting of version in "already installed" error message
Upgrading to 0.16.0 documentation (#1938) (7e8e5f6)exec-env callback (9e6b559)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
improve completions for Zsh and Fish
correct SliceToMap environment variable parsing function
The rewrite tries to maintain feature parity with the previous version. However, a number of breaking changes were introduced. Some of these were due…
A warning has also been added to the Bash code for asdf in 0.16.0. anyone trying to use asdf as they did in version 0.15.0 and earlier will get a warning message instructing them to follow the upgrade guide.
The full list of pull requests and merge commits for this rewrite are listed below.
(3a9f539) (f41ce90) (#1833) (4f9a5d3) (d06d71f) (7d5281a) (8ad3472) (b40beb6) (b23e5a3) (bc05110) (477e9d5) (6d708b2) (572ed07) (19a0597) (b33ab64) (b966ca6) (8db188a) (3fd4a83) (09d06ff) (d2afb85) (778ab34) (9f09f78) (6568891) (771f184) (8313ebc) (be52d8f) (c2e5ee6) (9097696) (ad0907a) (2b02f51) (c480044) (26b91aa) (202cdae) (325cd33) (07b5813) (822e14c) (53cd454) (9f6a65f) (bd7ab9a) (b6ec89f) (162cb8e) (d94bace) (e7df5ff) (369beeb) (#1829) (f68b29b) (26a3815) (ccc98ad) (447acd1) (72c20b1) (924eecf) (f5a5967) (3af0291) (9ed4216) (b9e79e6) (626bde0) (f639f8a) (c0963a3) (cb49b64) (f74efbf) (15e1f06) (620c0d8) (518a0fa) (5d5d04f) (2fc8006) (c859384) (2951011) (c5092c6) (3f9744d) (985c181) (18e21c9) (0058988) (#1820) (c3bd8fe) (8394e85) (5266ba5) (3155dc3) (7dfa8b4) (5a24864) (80ac9bb) (#1849) (8b1b024) (1b3c426) (163d6b4) (87d3c06) (3f17a80) (#1841) (251812b) (#1852) (78a00fc) (6b45a5e) (2a31caf) (7439ea9) (88af4ee)
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
golang-rewrite: remove asdf update command to prepare for Go version
Only display the "can't keep downloads" warning when asked to keep downloads
plugin test git-ref to use plugin repo default branch
pipefail (#1608)plugin test git-ref to use plugin repo default branch (#1694) (6d8cf9d)ASDF_NU_DIR (#1660) (dfea89c)pipefail (#1608) (4085e55)asdf version command under help.txt UTILS section (#1673) (240a5fb)def --env instead of def-env (#1681) (3b8f400)bin/ directory (#1643) (61420ad)Nothing published for this version
fish: use builtin realpath over system one
upgrade deps & fix breaking changes
plugin list exit code 0 when no plugins are installed (#1597)plugin list exit code 0 when no plugins are installed (#1597) (a029c00)Remove files containing only asdf wrapper functions
asdf wrapper functions (#1525)ASDF_${LANG}_VERSION usage (#1528) (63f422b)asdf info show BASH_VERSION & all asdf envs (#1513) (a1b5eee)mkdir -p (#1563) (d6185a2)nullglob guard (#1545) (f273612)ASDF_FORCE_PREPEND variable on POSIX entrypoint (#1560) (5b7d0fe)bin/asdf (#1516) (13c0e2f)asdf wrapper functions (#1525) (00fee78)asdf_tool_versions_filename (#1544) (b36ec73)asdf shim-versions completions in fish & bash (#1554) (99623d7).tool-versions or asdfrc contains carriage returns (#1561) (097f773)Prepend asdf directories to the PATH in Nushell
bash completion for latest command
Nothing published for this version
reshim did not rewrite executable path
reshim did not rewrite executable path (#1311) (5af7625)path: versions to use ~ (#1403) (670c96d)pwd (dd37b6f)scripts/checkstyle.py (#1385) (3492043)$(pwd) in favor of $PWD (f522ab9)Nothing published for this version
Disable short-name repository with config value
asdf list output (#762) (5ea6795)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
case-insensitive filtering of unstable versions in latest
latest (#1139) (e61e3d9)ls command (#1141) (87137e4)find errors (#1102) (5992abb)$PATH (#1174) (682b7a1)Nothing published for this version
Nothing published for this version
Nothing published for this version
asdf latest defer to plugin to determine the latest version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Support for latest version in shell, local, and global commands (#802, #801)
Features
Fixed Bugs
echo command from asdf codebase (#806, #781)sort -V command from the asdf codebase (#755, #867)plugin update --all so that the default branch is used for each plugin (#800)system version (#911)Documentation
.zshrc (#871)system version (#925, #868)Nothing published for this version
Add support for plugin documentation callback scripts (#512, #757)
Features
.tool-versions (#759, #760)asdf info command to print debug information (#786, #787)Fixed Bugs
PATH once in Fish shell (#767, #777, #778).tool-versions file path on shim error (#749, #750)column and sort -V to list of banned commands for the asdf codebase (#661, #754)column command in favor of awk (#721)asdf shell command to help output (#715, #737)asdf env command documentation (#717)asdf plugin-add exit code (#689)Nothing published for this version
Nothing published for this version
Add support for post-plugin-add and pre-plugin-remove in plugins. Add configurable command hooks for plugin installation and removal (#670, #683)
Features
Add support for post-plugin-add and pre-plugin-remove in plugins. Add configurable command hooks for plugin installation and removal (#670, #683)
pre_asdf_plugin_remove = echo will remove plugin ${1}
pre_asdf_plugin_remove_foo = echo will remove plugin foo
post_asdf_plugin_remove = echo removed plugin ${1}
post_asdf_plugin_remove_foo = echo removed plugin foo
Use different exit code if updates are disabled (#676)
Fixed Bugs
Make sure extension commands are properly displayed by asdf help
Extension commands are now expected to be inside plugins's lib/commands/command-*.bash instead of bin/command*.
This change was made for two reasons: Keep the convention that all files to be sourced by bash should end with
the .bash extension. And the lib/commands/ directory mirrors the location of asdf own core commands.
Added tests to make sure asdf help properly displays available extension commands.
Remove automatic compinit from asdf.sh (#674, #678)
Add .bash file extension to files executed by Bash
Features
Fixed Bugs
plugin-add (#643)--unset for Fish shell (#640)Improve output format of asdf plugin list all
Features
Improve output format of asdf plugin list all
Long plugin names were causing problems with how we used printf.
Now we use the column command to properly render output.
Now asdf plugin list can take both --urls and --refs options.
When --url is used, we print the plugin's remote origin URL.
While --refs prints the git branch/commit the plugin is at.
It's now possible to update a plugin to an specific branch/commit.
asdf plugin update <name> [git-ref]
Checkouts a plugin to the specified git-ref. Defaults to master
Now the asdf plugin test command can be specified with a plugin commit/branch to test.
This will help CI checks to actually test the commit they are running for.
Previously we always used the plugin's master branch.
Subcommand CLI support.
Users familiar with sub-command aware tools like git can now
use asdf commands in the same way. For example:
asdf plugin list all is equivalent to asdf plugin-list-all
This is also the case for plugin extension commands, where the
plugin name is an asdf main subcommand. ie. Having a foo plugin
you can invoke: asdf foo bar
Make asdf plugin test use the new asdf latest command. (#541)
If a plugin version is not given explicitly, we use asdf latest to
obtain the version of plugin to install for testing.
asdf --version displays git revision when asdf_dir is a git clone.
This will allow better bug reports since people can now include the git commit they are using.
Add support for asdf extension commands.
Plugins can provide bin/command* scripts or executables that will
be callable using the asdf command line interface.
See docs/plugins-create.md for more info.
Add support for installing the latest stable version of a tool (#216)
asdf install python latest
asdf install python latest:3.7 # installs latest Python 3.7 version
Add asdf latest command to display the latest stable version of a tool (#575)
asdf latest python
asdf latest python 3.7 # displays latest Python 3.7 version
Add support for filtering versions returned by asdf list-all
asdf list-all python 3.7 # lists available Python 3.7 versions
Add AppVeyor config for builds on Windows, for eventual Windows support (#450, #451)
Features
--unset flag to shell command (#563)Fixed Bugs
path:... versions are handled correctly (#559, #591)One column per quarter.