Skip to content

Install script - #7

Merged
tweinmann merged 3 commits into
mainfrom
install-script
Oct 29, 2026
Merged

tweinmann merged 3 commits into
mainfrom
install-script

Conversation

@tweinmann

Copy link
Copy Markdown
Owner

Installing siding becomes one line, before v0.5.0 is tagged:

curl -fsSL https://raw.githubusercontent.com/tweinmann/siding/main/install.sh | sh

install.sh

  • POSIX sh, also tested under dash. Uses curl or wget, and sha256sum or shasum.
  • Detects macOS or Linux and arm64 or amd64. On any other platform it stops with a message naming the supported ones.
  • Downloads the binary and SHA256SUMS from releases/latest/download, without the GitHub API. SIDING_VERSION picks another release.
  • On a checksum mismatch or a missing line, it installs nothing.
  • Installs to ~/.local/bin without sudo. SIDING_INSTALL_DIR picks another directory. If the directory is not on the PATH, it prints the export line to add.
  • Prints siding version and the next step. Running it again updates siding.
  • No xattr is needed: curl and wget do not set macOS's quarantine flag.

Test

hack/test-install.sh is part of just test. It serves a locally built release on loopback, so it needs no Docker and no network, and leaves nothing behind. It checks:

  • install
  • update
  • an install directory missing from the PATH
  • a checksum mismatch, which installs nothing
  • Windows and a 32-bit system, which are refused
  • no release found

README

Step 1 of "Get started" leads with the one-liner. Below it: how to read the script before running it, and, folded, the manual way (with xattr for browser downloads) and go install.

Spec

releases: "Install instructions" now leads with the script, and a new requirement "Install script" covers its behaviour. The change is archived as openspec/changes/archive/2026-10-29-install-script.

After merge

Tag v0.5.0. That is the first run of the release workflow, and the first chance to try the one-liner against a real release; until then latest/download answers 404.

🤖 Generated with Claude Code

tweinmann and others added 3 commits October 29, 2026 21:11
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tweinmann
tweinmann merged commit 186d080 into main Oct 29, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant