Repository navigation
Releases
0.1.0
The first stable release. If you run a beta, sne update moves you to it. From now on a stable sne is
offered stable releases only.
Security
- Linux and macOS: an altered or damaged Node.js archive can no longer write files outside the folder
it is unpacked into. The archive is unpacked while it downloads, before its SHA-256 can be checked,
and a link in it followed by a file "inside" that link could write anywhere the user can. Now links
must point inside the install folder, nothing is written through a link, a hard link may only name
another file of the archive, and an absolute path is skipped. The checksum still failed in that
case, but too late. Please update. - Linux and macOS: setuid, setgid and sticky bits in an archive are dropped. They mattered when sne ran
as root, for example in a container. - Windows: sne shows its notifications itself, through the Windows API. It used to start Windows
PowerShell with an encoded script from a scheduled task, which is also how a lot of malware behaves
and what antivirus programs look for.
New
sne install <version> --reinstall-packages-from <installed version>installs the global npm
packages of one version into another, at the same versions. Global packages belong to one Node
version, so a new version used to start without them.
Changes
- Downloads are tried again, twice, after a dropped connection or a busy server (HTTP 5xx or 429).
One hiccup used to fail the whole install. A download that stops sending for good ends after 30
minutes instead of waiting forever. sne uninstallmoves the version aside before deleting it, so a version in use is never left half
removed. Before, a runningnodecould stop the delete halfway, after its aliases were gone.- New version notifications check every 4 hours instead of once a day, so you hear about a release on
the day it comes out. The notification reads "Update available" with the new version. If you turned
notifications on before, runsne notify ononce more to switch to the new schedule. - HTTPS certificates are checked against the system's certificate store, like a browser or curl does.
Behind a company proxy that inspects HTTPS, every download used to fail with a certificate error.
A Linux system with no certificate bundle, such as a slim container, still works with the
certificates built into sne. - Apple silicon and Windows on ARM: a Node version with no build for the processor, such as Node 14 on
a Mac with an M chip, is installed as its x64 build, which runs under emulation. Before, sne said no
release matched. SNE_ARCHchooses the processor type of the Node builds to install, for exampleSNE_ARCH=x64.- Proxies set in
HTTPS_PROXY,ALL_PROXYandNO_PROXYare now documented. cargo install sneno longer needs--version.- On npm, a stable release is
latestand a beta isnext:npm install -g sne-cligives the stable
version, andnpm install -g sne-cli@nextthe newest beta.
Removed
Fewer, better-tested files. Nobody on a supported system loses anything.
- 32-bit Windows. Node.js stopped publishing 32-bit Windows builds after version 22, which reaches
its end of life in April 2027, and Windows 11 has no 32-bit edition. 0.1.0-beta.5 is the last sne for
it. On a 64-bit Windows,SNE_ARCH=x86still installs 32-bit Node.js builds. - The glibc Linux files (
*-unknown-linux-gnu.tar.gz). The static*-unknown-linux-muslfiles
run on every Linux, and the packages,install.sh,sne update, Homebrew and npm already used them. - The Alpine
.apkand the Arch package file. On Alpine or Arch, remove the package
(sudo apk del sneorsudo pacman -R sne), then install withinstall.sh, whichsne updatekeeps
up to date. There is no AUR package.
This release is about security. Please update.
Security
- Windows: new version notifications are no longer turned on by sne,
install.ps1or the setup wizard. Windows Defender reported the daily update-check task asBehavior:Win32/Persistenceand deleted sne.sne notify onstill turns them on. Linux and macOS are unchanged. - Project version files (
.nvmrc,.node-version,package.json) are read only when they are small regular files. A repository could make.nvmrca link to a private file, whose first line sne printed oncd, or put terminal escape codes in it. - Downloads use HTTPS only. A plain
http://address inSNE_NODE_MIRROR,SNE_RELEASES_URLorSNE_DOWNLOAD_BASEis refused, except for127.0.0.1andlocalhost, and so is a redirect from HTTPS to HTTP. - A stable sne is offered stable releases only by
sne updateand the notifications. A beta is offered both. - cmd: the setup lines are quoted, so a folder name with
&no longer runs part of the path as a command. sne doctorreports a data folder that other users can write to (Linux and macOS).- Every release file has a build provenance record:
gh attestation verify <file> --repo sne-sh/sne. sne.execarries its product name, version and icon.
Changes
-
install.ps1andinstall.shrun sne once before changingPATHor a profile, and say why when the system refuses to run it, for example Smart App Control. -
install.ps1and the setup wizard leave a PowerShell profile alone when the execution policy would refuse to load it. -
sne updateleaves an install from Scoop, Homebrew, npm, Cargo or a Linux package to that package manager, and prints its command. -
The
cdhook runs the sne program directly. With an npm install, a change of folder went from about 94 ms to 12 ms on Windows. -
Install with Scoop (
scoop bucket add sne https://github.com/sne-sh/sne) or Homebrew (brew tap sne-sh/sne https://github.com/sne-sh/sne). -
sne is on crates.io:
cargo install sne --version <version>. -
sne is on npm as
sne-cli:npm install -g sne-cli, or the same with yarn, pnpm or bun. -
The README has a privacy section and a code signing policy.
-
Windows:
sne use,sne defaultand the firstsne installadd the default Node version to yourPATHwhen it is missing. It was missing when sne was installed before 0.1.0-beta.2 and then updated withsne update, and aftercargo installor the zip file. Before, sne only said to open a new terminal, and Node was still missing there. -
sne leaves
PATHalone whenSNE_DIRorSNE_NO_MODIFY_PATH=1is set, and prints the folder to add. -
sne use,sne defaultandsne doctorsay when another Node comes first onPATH. -
sne doctorreports a default that points to a version that is no longer installed. -
sne uninstallsays when it leaves no default version. -
New version notifications are on by default. The Windows installers turn them on, and elsewhere sne turns them on at the first
sne installon a desktop.sne notify offturns them off, andSNE_NO_NOTIFY=1skips them when installing. -
Notifications,
sne updateandsne self checknow include beta releases. -
No setup step after installing on Windows: the installers put the default Node version on
PATH, sonodeandsne usework in every terminal, including cmd, Git Bash and both PowerShell editions. -
sne usein a terminal without the setup line now switches the version for every terminal, where it used to stop with an error. -
install.ps1sets up Windows PowerShell 5.1 and PowerShell 7 together. -
The Linux packages add the default Node version to
PATHfor login shells. -
Short forms:
sne -vfor the version, and one- or two-letter names for the common commands (i,u,d,l,lr,rm,c,w,x,up,dr). -
Release notes come from this changelog.
First public release, as a beta.
install,use,default,ls,ls-remote,uninstall,current,which,exec,alias,unalias,env,completions,doctor.- Shell setup for bash, zsh, fish, PowerShell and cmd, with optional automatic switching on
cd. - Reads
.nvmrc,.node-versionandengines.nodeinpackage.json. - SHA-256 verification of every download; parallel installs; cached release list.
- Windows, Linux (glibc and musl) and macOS.
- Windows installers: a PowerShell one-liner (
install.ps1) and a setup wizard built with Inno Setup. - Windows builds for x64, x86 (32-bit) and ARM64, each as a setup wizard and a portable zip.
- Linux and macOS:
install.sh, a universal macOS.pkg, and.deb,.rpm,.apkand Arch packages. - Documentation in
docs/(published with GitBook) and a project website insite/. sne self checklooks for a new sne version;sne notify onshows a desktop notification when one is out (Task Scheduler, launchd or a systemd user timer). Off by default.sne updatereplaces sne with the latest release, after checking its SHA-256.
Install
Windows, in PowerShell:
irm https://raw.githubusercontent.com/sne-sh/sne/main/install.ps1 | iexmacOS and Linux:
curl -fsSL https://raw.githubusercontent.com/sne-sh/sne/main/install.sh | shAlready have sne? Run sne update.
You can also download a file below: a setup wizard or portable zip for Windows, a .pkg for macOS, and .deb, .rpm or .tar.gz files for Linux. On Arch and other distributions, use install.sh. Each one is listed with its SHA-256 in SHA256SUMS.txt.
0.1.0-beta.5
This release is about security. Please update.
Security
- Windows: new version notifications are no longer turned on by sne,
install.ps1or the setup wizard. Windows Defender reported the daily update-check task asBehavior:Win32/Persistenceand deleted sne.sne notify onstill turns them on. Linux and macOS are unchanged. - Project version files (
.nvmrc,.node-version,package.json) are read only when they are small regular files. A repository could make.nvmrca link to a private file, whose first line sne printed oncd, or put terminal escape codes in it. - Downloads use HTTPS only. A plain
http://address inSNE_NODE_MIRROR,SNE_RELEASES_URLorSNE_DOWNLOAD_BASEis refused, except for127.0.0.1andlocalhost, and so is a redirect from HTTPS to HTTP. - A stable sne is offered stable releases only by
sne updateand the notifications. A beta is offered both. - cmd: the setup lines are quoted, so a folder name with
&no longer runs part of the path as a command. sne doctorreports a data folder that other users can write to (Linux and macOS).- Every release file has a build provenance record:
gh attestation verify <file> --repo sne-sh/sne. sne.execarries its product name, version and icon.
Changes
install.ps1andinstall.shrun sne once before changingPATHor a profile, and say why when the system refuses to run it, for example Smart App Control.install.ps1and the setup wizard leave a PowerShell profile alone when the execution policy would refuse to load it.sne updateleaves an install from Scoop, Homebrew, npm, Cargo or a Linux package to that package manager, and prints its command.- The
cdhook runs the sne program directly. With an npm install, a change of folder went from about 94 ms to 12 ms on Windows. - Install with Scoop (
scoop bucket add sne https://github.com/sne-sh/sne) or Homebrew (brew tap sne-sh/sne https://github.com/sne-sh/sne). - sne is on crates.io:
cargo install sne --version <version>. - sne is on npm as
sne-cli:npm install -g sne-cli, or the same with yarn, pnpm or bun. - The README has a privacy section and a code signing policy.
Install
Windows, in PowerShell:
irm https://raw.githubusercontent.com/sne-sh/sne/main/install.ps1 | iexmacOS and Linux:
curl -fsSL https://raw.githubusercontent.com/sne-sh/sne/main/install.sh | shAlready have sne? Run sne update.
You can also download a file below: a setup wizard or portable zip for Windows, a .pkg for macOS, and .deb, .rpm, .apk, Arch or .tar.gz files for Linux. Each one is listed with its SHA-256 in SHA256SUMS.txt.
0.1.0-beta.4
- Windows:
sne use,sne defaultand the firstsne installadd the default Node version to yourPATHwhen it is missing. It was missing when sne was installed before 0.1.0-beta.2 and then updated withsne update, and aftercargo installor the zip file. Before, sne only said to open a new terminal, and Node was still missing there. - sne leaves
PATHalone whenSNE_DIRorSNE_NO_MODIFY_PATH=1is set, and prints the folder to add. sne use,sne defaultandsne doctorsay when another Node comes first onPATH.sne doctorreports a default that points to a version that is no longer installed.sne uninstallsays when it leaves no default version.
Install
Windows, in PowerShell:
irm https://raw.githubusercontent.com/sne-sh/sne/main/install.ps1 | iexmacOS and Linux:
curl -fsSL https://raw.githubusercontent.com/sne-sh/sne/main/install.sh | shAlready have sne? Run sne update.
You can also download a file below: a setup wizard or portable zip for Windows, a .pkg for macOS, and .deb, .rpm, .apk, Arch or .tar.gz files for Linux. Each one is listed with its SHA-256 in SHA256SUMS.txt.
0.1.0-beta.3
- New version notifications are on by default. The Windows installers turn them on, and elsewhere sne turns them on at the first
sne installon a desktop.sne notify offturns them off, andSNE_NO_NOTIFY=1skips them when installing. - Notifications,
sne updateandsne self checknow include beta releases.
Install
Windows, in PowerShell:
irm https://raw.githubusercontent.com/sne-sh/sne/main/install.ps1 | iexmacOS and Linux:
curl -fsSL https://raw.githubusercontent.com/sne-sh/sne/main/install.sh | shAlready have sne? Run sne update.
You can also download a file below: a setup wizard or portable zip for Windows, a .pkg for macOS, and .deb, .rpm, .apk, Arch or .tar.gz files for Linux. Each one is listed with its SHA-256 in SHA256SUMS.txt.
0.1.0-beta.2
- No setup step after installing on Windows: the installers put the default Node version on
PATH, sonodeandsne usework in every terminal, including cmd, Git Bash and both PowerShell editions. sne usein a terminal without the setup line now switches the version for every terminal, where it used to stop with an error.install.ps1sets up Windows PowerShell 5.1 and PowerShell 7 together.- The Linux packages add the default Node version to
PATHfor login shells. - Short forms:
sne -vfor the version, and one- or two-letter names for the common commands (i,u,d,l,lr,rm,c,w,x,up,dr). - Release notes come from this changelog.
Install
Windows, in PowerShell:
irm https://raw.githubusercontent.com/sne-sh/sne/main/install.ps1 | iexmacOS and Linux:
curl -fsSL https://raw.githubusercontent.com/sne-sh/sne/main/install.sh | shAlready have sne? Run sne update.
You can also download a file below: a setup wizard or portable zip for Windows, a .pkg for macOS, and .deb, .rpm, .apk, Arch or .tar.gz files for Linux. Each one is listed with its SHA-256 in SHA256SUMS.txt.
0.1.0-beta.1
Full Changelog: https://sne-sh.github.io/sne/#changelog
First public release, as a beta.
install,use,default,ls,ls-remote,uninstall,current,which,exec,alias,unalias,env,completions,doctor.- Shell setup for bash, zsh, fish, PowerShell and cmd, with optional automatic switching on
cd. - Reads
.nvmrc,.node-versionandengines.nodeinpackage.json. - SHA-256 verification of every download; parallel installs; cached release list.
- Windows, Linux (glibc and musl) and macOS.
- Windows installers: a PowerShell one-liner (
install.ps1) and a setup wizard built with Inno Setup. - Windows builds for x64, x86 (32-bit) and ARM64, each as a setup wizard and a portable zip.
- Linux and macOS:
install.sh, a universal macOS.pkg, and.deb,.rpm,.apkand Arch packages. - Documentation in
docs/(published with GitBook) and a project website insite/. sne self checklooks for a new sne version;sne notify onshows a desktop notification when one is out (Task Scheduler, launchd or a systemd user timer). Off by default.sne updatereplaces sne with the latest release, after checking its SHA-256.
Install
Windows, in PowerShell:
irm https://raw.githubusercontent.com/sne-sh/sne/main/install.ps1 | iexmacOS and Linux:
curl -fsSL https://raw.githubusercontent.com/sne-sh/sne/main/install.sh | shAlready have sne? Run sne update.
You can also download a file below: a setup wizard or portable zip for Windows, a .pkg for macOS, and .deb, .rpm, .apk, Arch or .tar.gz files for Linux. Each one is listed with its SHA-256 in SHA256SUMS.txt.