github.com/asdf-vm/asdf

0.20.0 (2026-07-07)

Features

• add warning to asdf info output when ASDF_TOOL_VERSIONS_FILENAME value is invalid (#2293) (244e513)

Bug Fixes

• shallow clone plugin repositories for faster installs (#2256) (badc9db)
• update nushell completion code so it works on latest version of nushell (#2275) (51ebfb4)

Features

• add warning to asdf info output when ASDF_TOOL_VERSIONS_FILENAME value is invalid (#2293) (244e513)

Bug Fixes

• shallow clone plugin repositories for faster installs (#2256) (badc9db)
• update nushell completion code so it works on latest version of nushell (#2275) (51ebfb4)

0.19.0 (2026-04-24)

Features

• don't override semver ordering during completion (#2263) (aaa84d2)

Bug Fixes

• convert hyphens to underscores when converting plugin names to generate valid environment variables (2ffb5b8)
• make plugin test command resolve latest version properly (1485ff4)
• nushell completions --ignore-errors deprecation (#2157) (a813610)
• return error from repo.RemoteUrl function (71e9567)
• set ASDF_INSTALL_* environment variables for reshim command (3ec1610)
• use os.PathListSeparator (#2195) (d5efb1e)

Features

• don't override semver ordering during completion (#2263) (aaa84d2)

Bug Fixes

• convert hyphens to underscores when converting plugin names to generate valid environment variables (2ffb5b8)
• make plugin test command resolve latest version properly (1485ff4)
• nushell completions --ignore-errors deprecation (#2157) (a813610)
• return error from repo.RemoteUrl function (71e9567)
• set ASDF_INSTALL_* environment variables for reshim command (3ec1610)
• use os.PathListSeparator (#2195) (d5efb1e)

0.18.1 (2026-03-02)

Bug Fixes

• Only show already installed versions in shell completion for the asdf set command (#2172) (c3910d7)
• set LANG=C for locale-dependent tests (#2197) (2423f6d)

Bug Fixes

• Only show already installed versions in shell completion for the asdf set command (#2172) (c3910d7)
• set LANG=C for locale-dependent tests (#2197) (2423f6d)

0.18.0 (2025-06-07)

Features

• asdf list exit with status code of 0 when no versions installed (#2116) (e7d5289)

Bug Fixes

• correct flag handling in commands run by asdf exec (#2115) (d6cd693)
• only return version starting with number when no filter is supplied (#2120) (cf29b51)
• print all error output to stderr when shim can't be resolved (#2109) (c9049ea)
• rename tool version filename environment variable for clarity (#2101) (e3d6014)
• upgrade urfave/cli to version 3 (#2105) (392d09a)

Features

• asdf list exit with status code of 0 when no versions installed (#2116) (e7d5289)

Bug Fixes

• correct flag handling in commands run by asdf exec (#2115) (d6cd693)
• only return version starting with number when no filter is supplied (#2120) (cf29b51)
• print all error output to stderr when shim can't be resolved (#2109) (c9049ea)
• rename tool version filename environment variable for clarity (#2101) (e3d6014)
• upgrade urfave/cli to version 3 (#2105) (392d09a)

0.17.0 (2025-05-19)

Features

• add back support for shim templates resolution (#2076) (a3bccea)
• log failure to add plugin in "plugin test" (#2059) (92de803)
• switch back to native git client (#1998) (1efa2bb)

Bug Fixes

• address linter warning (67581cf)
• correct intersection logic in shims.FindExecutable function so ordering of multiple versions is preserved (#2063) (083f20a)
• correct output of install command when system or path version set (#2097) (82d67e3)
• ensures output always ends with a newline when printed (#2098) (6f4837e)
• handle tilde in env vars (#2092) (6da599a)
• remove default error action from plugin command (#2027) (c376481)
• remove unused ForcePrepend option from Go code (#2089) (49e9f33)
• set correct version for go install and make builds (#2077) (4c73527)

Features

• golang-rewrite: add support for shim templates resolution (#2076) (a3bccea)
• log failure to add plugin in "plugin test" (#2059) (92de803)
• switch back to native git client (#1998) (1efa2bb)

Bug Fixes

• address linter warning (67581cf)
• correct intersection logic in shims.FindExecutable function so ordering of multiple versions is preserved (#2063) (083f20a)
• correct output of install command when system or path version set (#2097) (82d67e3)
• ensures output always ends with a newline when printed (#2098) (6f4837e)
• handle tilde in env vars (#2092) (6da599a)
• remove default error action from plugin command (#2027) (c376481)
• remove unused ForcePrepend option from Go code (#2089) (49e9f33)
• set correct version for go install and make builds (#2077) (4c73527)

0.16.7 (2025-03-25)

Bug Fixes

• remove comment from first line zsh completion output (#2035) (#2037) (74d7b17)

Bug Fixes

• remove comment from first line zsh completion output (#2035) (#2037) (74d7b17)

0.16.6 (2025-03-21)

Bug Fixes

• correct ASDF_INSTALL_* envvar unset test (#2006) (6fbf94a)
• correct concurrency to align with documentation (#2014) (807ea38)
• correct handling of ASDF_FORCE_PREPEND environment variable (#2011) (43a84a0)
• improve zsh completion suggestions (#2022) (b1cf58d)
• remove filtering from latest-stable call (#2032) (6fcdcdf)
• remove install directory for version when install fails (#2024) (932ac46)

Bug Fixes

• correct ASDF_INSTALL_* envvar unset test (#2006) (6fbf94a)
• correct concurrency to align with documentation (#2014) (807ea38)
• correct handling of ASDF_FORCE_PREPEND environment variable (#2011) (43a84a0)
• improve zsh completion suggestions (#2022) (b1cf58d)
• remove filtering from latest-stable call (#2032) (6fcdcdf)
• remove install directory for version when install fails (#2024) (932ac46)

0.16.5 (2025-03-04)

Bug Fixes

• always propagate env variables when executing commands (#1982) (80265a8)
• build static binary to improve portability (#1993) (45047a6)
• correct exit status when sub-command does not exist (#1991) (3dd0dd3), closes #1928
• latest version returns latest version (#1996) (0ceac7a)
• preserve files untracked by Git on plugin update (#1995) (d4d8db0)
• set correct env vars on recursive calls (#1989) (97a91cc)
• simplify env vars parsing (#1988) (8990b6b), closes #1986

Bug Fixes

• always propagate env variables when executing commands (#1982) (80265a8)
• build static binary to improve portability (#1993) (45047a6)
• correct exit status when sub-command does not exist (#1991) (3dd0dd3), closes #1928
• latest version returns latest version (#1996) (0ceac7a)
• preserve files untracked by Git on plugin update (#1995) (d4d8db0)
• set correct env vars on recursive calls (#1989) (97a91cc)
• simplify env vars parsing (#1988) (8990b6b), closes #1986

0.16.4 (2025-02-19)

Bug Fixes

• Add a newline delimiter when suggesting versions to install (#1972) (38bea71)
• correct version resolution order to restore legacy file fallback behavior (#1956) (6696d47)
• support environment variables with equals sign and newlines in value (#1977) (1acf082)

Bug Fixes

• Add a newline delimiter when suggesting versions to install (#1972) (38bea71)
• correct version resolution order to restore legacy file fallback behavior (#1956) (6696d47)
• support environment variables with equals sign and newlines in value (#1977) (1acf082)

0.16.3 (2025-02-17)

Bug Fixes

• add missing version command (#1931) (5339c41)
• correct formatting of version in "already installed" error message (df5e283)
• correct typo in Upgrading to 0.16.0 documentation (#1938) (7e8e5f6)
• don't error if version already installed (06f8990)
• pass environment variables through to exec-env callback (9e6b559)
• repair invalid fish shell completion code (#1936) (8388f99)
• return no error from shims.RemoveAll when shims dir missing (#1967) (45c31c9)

Bug Fixes

• add missing version command (#1931) (5339c41)
• correct formatting of version in "already installed" error message (df5e283)
• correct typo in Upgrading to 0.16.0 documentation (#1938) (7e8e5f6)
• don't error if version already installed (06f8990)
• pass environment variables through to exec-env callback (9e6b559)
• repair invalid fish shell completion code (#1936) (8388f99)
• return no error from shims.RemoveAll when shims dir missing (#1967) (45c31c9)

Bug Fixes

• correct Bash completion (#1886) (fdb1bc7)
• improve completions for Zsh and Fish (#1912) (2f806de)
• correct help for asdf set command (#1920) (554b4ea)
• correct help for asdf set command in Bash completion (#1921) (63e7dca)
• improve Zsh completion suggestions (#1925) (e190624)
• run go tests when go.mod or go.sum change (#1917) (6e4a7b5)
• fix typo (#1897) (98ffa86)
• update make utils script to set correct version (892736b)
• update urfave/cli to fix cmd output (#1914) (3525e9e)

Bug Fixes

• correct SliceToMap environment variable parsing function (#1879) (e63aec6)
• remove old hyphenated command from help (1f0296a)
• replace reference to removed subcommands (#1868) (0785d35)
• revert change to old Bash help text (de019fd)
• use version in home dir when no version found in root dir (#1883) (5ae5f76)

Features

• Rewrite asdf in Golang The rewrite in Go was spread across 88 pull requests that are all included in this release. The primary goal of the rewrite was to create a codebase that was faster, simpler and easier to maintain. The rewrite tries to maintain feature parity with the previous version. However, a number of breaking changes were introduced. Some of these were due to the change of language, a few out of a desire to simplify the code, and some to improve the user experience. For the full list of breaking changes and the upgrade guide visit the Upgrading to 0.16.0 page on the asdf website. It is highly recommended that you read this guide before upgrading.

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)

Bug Fixes

• bash command set end of line LF (#1847) (8211421)

Features

• golang-rewrite: remove asdf update command to prepare for Go version (#1806) (15571a2)

Patches

• completions: Address two Bash completion bugs (#1770) (ebdb229)
• make plugin-test work on alpine linux (#1778) (f5a1f3a)
• nushell: nushell spread operator (#1777) (a0ce37b)
• nushell: Use correct env var for shims dir (#1742) (2f07629)
• when download path got removed, it should use -f to force delete the download files (#1746) (221507f)

Documentation

• add Korean translation (#1757) (9e16306)
• propose edits for tiny typographical/grammatical errors (#1747) (d462b55)
• split Lint and Test badges for title asdf in README.MD (#1725) (c778ea1)
• Update Japanese(ja-jp) Translations (#1715) (bd19e4c)