Skip to content

An installer is downloaded, readable and pinned to its release, and it asks before it acts

Decision 682 · accepted · 2026-09-24

A pipe from curl into sh, or from irm into iex, runs whatever arrives. A cut-off download runs as far as it got, nobody reads the script first, and iex leaves the script's variables and $ErrorActionPreference in the person's session. - Attached and pinned. Each release now attaches install.sh and install.ps1, covered by its SHA256SUMS. scripts/release-installers writes the release's version into both, so the copy on a release page installs that release, a release candidate or a pre-release included, without TROUPE_VERSION. - Download, read, run. The notes and READMEs say to download the script, read it if you like, and run it. On Windows that is powershell -ExecutionPolicy Bypass -File, because the default policy runs no script. - It asks. In a terminal, with neither --tui nor --gui, the installer asks about each client: yes by default on a fresh machine, otherwise yes for what is already installed. It then prints a plan (downloads, processes to stop, what it replaces, removes and adds to PATH) and asks before doing any of it. -y asks nothing. Without a terminal nothing is asked, and naming neither client needs -y, as before. - Next steps. It ends with the model settings (682) and what to do next. - Clean install. --clean-install (-CleanInstall) removes the current install once the downloads check out, keeping config and state unless --purge is given. - The TUI's payload. A running TUI is stopped with the daemon, and Burrito's payload is cleared on every TUI install, as install-local does. Otherwise a release of the version a local build carried would run the build. - Fixes found on the way. - The PATH line goes to the file the person's shell reads. A fresh Mac has no ~/.zshrc, and zsh never reads ~/.profile. - Windows waits for the desktop app's NSIS uninstaller by its registry entry, because the uninstaller returns before it is done. - Windows PowerShell's progress bar is off, because it made the downloads many times slower. - Burrito reads TROUPE_INSTALL_DIR as where to unpack the TUI, so the bin directory's override is now TROUPE_BIN_DIR. install.sh still reads the old name and unsets it.

Governs: docs/user/vscode.md