Install Stackie

Installs stackie and stackied to ~/.stackie/bin/. No sudo or admin rights required.

macOS (ARM64 & x86_64)

Supports Apple Silicon (M1–M4) and Intel Macs running macOS 11 (Big Sur) or later.

Run in Terminal:

curl -fsSL https://stackie.dev/install.sh | sh

What this does:

Downloads stackie and stackied for your architecture
Verifies SHA256 checksums before installing
Installs to ~/.stackie/bin/
Adds ~/.stackie/bin to your shell PATH

Verify installation:

stackie --version

After install, you may need to run source ~/.zshrc (or source ~/.bashrc) to use stackie in your current terminal session.

Linux (x86_64 & ARM64)

Statically linked musl binary — works on Ubuntu 20.04+, Debian, Fedora, Arch, and others. No glibc dependency.

Run in your shell:

curl -fsSL https://stackie.dev/install.sh | sh

What this does:

Downloads static musl binaries for your architecture
Verifies SHA256 checksums before installing
Installs to ~/.stackie/bin/
Adds ~/.stackie/bin to your shell PATH

Ubuntu 23.10+ note

Ubuntu 23.10+ restricts unprivileged user namespaces, which are required for some Stackie sandbox features. You may need to configure AppArmor. See Linux setup guide.

Verify installation:

stackie --version

Windows (x86_64)

Requires Windows 10 or later (64-bit). No administrator rights needed. PowerShell 5.1+ (pre-installed on Windows 10+).

Run in PowerShell:

powershell -c "irm stackie.dev/install.ps1 | iex"

What this does:

Downloads stackie.exe and stackied.exe
Verifies SHA256 checksums using Get-FileHash
Installs to %USERPROFILE%\.stackie\bin\
Adds the install directory to your user-level PATH (registry)

Windows Defender note

Windows Defender SmartScreen may prompt on first run because the binaries are downloaded from the internet. Click "More info" → "Run anyway" to proceed. See Windows setup guide.

Verify installation (open a new terminal):

stackie --version

Want to inspect the script first?

Download the script, review it, then run it manually:

# macOS / Linux
curl -fsSL https://stackie.dev/install.sh -o install.sh
less install.sh    # review
sh install.sh

# Windows (PowerShell)
irm stackie.dev/install.ps1 -OutFile install.ps1
notepad install.ps1    # review
.\install.ps1

Updating

Once installed, use the built-in update command to stay current. This updates all three binaries atomically.

stackie update

# Install a specific version
stackie update --version 0.9.0

Uninstalling

Remove the install directory and clean up PATH entries:

macOS / Linux:

# Remove binaries and data
rm -rf ~/.stackie

# Remove PATH entry from your shell rc file
# Edit ~/.zshrc or ~/.bashrc and delete the
# # stackie start ... # stackie end block

Windows:

# In PowerShell (removes binaries and data)
Remove-Item -Recurse -Force "$env:USERPROFILE\.stackie"

# Remove PATH entry (PowerShell)
$path = [Environment]::GetEnvironmentVariable('PATH','User')
$newPath = ($path -split ';' | Where-Object { $_ -notlike "*\.stackie\bin*" }) -join ';'
[Environment]::SetEnvironmentVariable('PATH', $newPath, 'User')