Performance & UX Improvements:

• Shell startup is now faster: fnm env --use-on-cd applies the initial version during fnm env itself, eliminating an extra fnm use subprocess
• Improved --use-on-cd shell hook robustness (zsh hook deduplication on re-source, Windows CMD fixes for paths with spaces and drive changes)

New Features:

• fnm install --use flag to automatically switch to the version after installing
• fnm default (with no arguments) now returns the current default version

Internal:

• Rust toolchain upgraded to 1.88

Docs/Maintenance:

• Various README improvements, typo fixes, and CI workflow fixes

Thanks to the new contributors: @SunsetTechuila, @MangelMaxime, @CodingWithAnxiety, @zeroberry, @isaacl :hat-tip:

Patch Changes

• #1326 172fb0a Thanks @Schniz! - fix --use-on-cd failing with newly released default of --resolve-engines when engines key didn't exist

Minor Changes

• #1265 186e4bb Thanks @Schniz! - enable --resolve-engines by default. out of experimental phase.

  to disable it, add a --resolve-engines=false flag, and make sure to open an issue describing why.
  It might feel like a breaking change but .nvmrc and .node-version have precedence so it should not.

  I am all in favor of better experience and I believe supporting engines.node is a good direction.

Patch Changes

• #1310 9273981 Thanks @Schniz! - make github releases of macos to be a universal macos executable (both m1 and x64) as github changed the workers to be m1

• #1277 12cf977 Thanks @deanshub! - Having install and uninstall aliases

• #1318 65f7a22 Thanks @Schniz! - better error handling for malformed json

Patch Changes

• #1264 364d2a9 Thanks @Schniz! - fix: allow to type powershell and power-shell as shell type inputs

• #1195 74d7c33 Thanks @mattmess1221! - When downloading from node-dist, Fallback to .tar.gz download when the .tar.xz download fails

• #1259 1000914 Thanks @skirsten! - Fix --resolve-engines in combination with --use-on-cd

• #1248 e03d345 Thanks @bburns! - docs: add link for windows terminal startup script configuration

• #1184 fefdf69 Thanks @julescubtree! - fix panic when list-remote --filter --latest has no results

• #1255 71c1c9a Thanks @stefanboca! - set aliases during install, even if corepack is enabled

• #1204 19bffe5 Thanks @JLarky! - Document how to use nightly builds

• #1218 345adaf Thanks @Schniz! - internal: retry download in case of error in test proxy

• #1226 8e2d37d Thanks @mo8it! - performance optimizations, especially for fnm env

• #1223 2b211ef Thanks @mo8it! - Allow reading non-unicode paths from environment variables

Patch Changes

• #1164 318f86d Thanks @Schniz! - windows: fix shell inference in powershell when using scoop's shims

• #1143 f76a001 Thanks @Schniz! - use XDG conventions in MacOS directories by default. Thank you @utkarshgupta137 for the initial work 🙏

Patch Changes

• #1148 0b530cc Thanks @Schniz! - fix ordering in ls-remote

• #1133 a1afe84 Thanks @Schniz! - upgrade all dependencies & maintain lockfile

Minor Changes

• #1063 121128f Thanks @ryanccn! - feat: add remote version sorting and filtering

• #896 7b47b3e Thanks @pedrofialho! - fnm install latest will now tag the latest alias

• #1028 66efc5b Thanks @eblocha! - Show a progress bar when downloading and extracting node

Patch Changes

• #1014 6be23c8 Thanks @tottoto! - Disable unused chrono features (#1014)

• #1050 d6c132a Thanks @JakeHandsome! - Fix cd /D on windows with --use-on-cd

• #1109 8f3acbb Thanks @Vinfall! - support x64-musl arch by adding a --arch x64-musl to fnm env

• #1125 d9af62f Thanks @Schniz! - make nicer styling in progress bar (add newline, make it unicode)

• #1058 734df47 Thanks @aquacash5! - fix: return default version if canonicalize fails

• #1066 9ff98da Thanks @floh1695! - Fixes a bug when running eval $(fnm env) in sh when there a spaces in the $PATH

Patch Changes

• #1010 b185446 Thanks @quixoten! - fix: panic on fnm completions

@amitdahan contributed a support for resolving package.json's engines.node field.

try that out with the --resolve-engines option and let us how it works out for you!

Minor Changes

• #839 97be792 Thanks @amitdahan! - Support resolving engines.node field via experimental --resolve-engines flag

Patch Changes

• #991 b19eb29 Thanks @amitdahan! - Bump Clap 3 -> 4

Minor Changes

• Add --corepack-enabled flag for automatically enabling corepack on fnm install (#960) @Schniz

Patch Changes

• modernize tty check (#973 by @tottoto) (48b2611) @Schniz

• use cygwinpath to make the path posix-like on Windows Bash usage (#960)

• capitalize "n" to show default (#963 by @Joshuahuahua) (48b2611)