Install

spl is a single self-contained binary — no runtime, no package manager, no dependencies. The install scripts below download the right build for your platform from releases.syncropic.com, place it in a user-scope location, add that location to your PATH, and verify the version.

Linux

curl -sSf https://get.syncropic.com/spl | sh

What the script does:

1. Detects your architecture (x86_64 or aarch64).
2. Downloads the matching spl-linux-<arch> binary from releases.syncropic.com.
3. Verifies the SHA-256 checksum.
4. Atomically moves the binary to $INSTALL_DIR (default ~/.local/bin/spl).
5. Adds ~/.local/bin to your PATH by appending an export line to your shell's rc file (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish).
6. Prints the next-step hints (spl init, spl serve).

If ~/.local/bin was already on your PATH, step 5 is skipped. If the script can't detect your shell, it prints the line for you to add manually.

The default install location can be overridden:

INSTALL_DIR=/usr/local/bin curl -sSf https://get.syncropic.com/spl | sh

/usr/local/bin requires sudo — the user-scope default does not.

Windows (PowerShell)

irm https://get.syncropic.com/spl.ps1 | iex

What the script does:

1. Detects x86_64 (ARM Windows is not yet supported).
2. Downloads spl-windows-x86_64.exe from releases.syncropic.com.
3. Verifies the SHA-256 checksum.
4. Moves the binary to %LOCALAPPDATA%\Programs\spl\spl.exe (user-scope; no admin needed).
5. Appends that directory to the user PATH in the registry.
6. Prints the next-step hints.

The user PATH update takes effect for new PowerShell / CMD sessions. Close and reopen your terminal before running spl version.

macOS

Prebuilt macOS binaries are published — the release pipeline builds both Apple Silicon (darwin-aarch64) and Intel (darwin-x86_64) targets for every tagged release. Install by downloading the binary directly:

# Apple Silicon (M1/M2/M3/M4):
curl -fsSL https://releases.syncropic.com/spl-rust/latest/spl-darwin-aarch64 -o spl

# Intel Mac:
curl -fsSL https://releases.syncropic.com/spl-rust/latest/spl-darwin-x86_64 -o spl

# Then make it executable and put it on your PATH:
chmod +x spl
mkdir -p ~/.local/bin && mv spl ~/.local/bin/
# Ensure ~/.local/bin is on PATH (add to ~/.zshrc if it isn't already):
export PATH="$HOME/.local/bin:$PATH"

spl version

To pin a specific release, swap latest for the version, e.g. .../spl-rust/0.79.0/spl-darwin-aarch64.

On first run, macOS Gatekeeper may quarantine a binary downloaded via curl. If macOS refuses to run it, clear the quarantine attribute: xattr -d com.apple.quarantine ~/.local/bin/spl.

Browse all published builds at the releases page.

Pinning to a specific version

The default install scripts fetch the version listed at https://releases.syncropic.com/spl-rust/latest/version.json. To pin to a specific release, set SPL_VERSION:

# Linux
SPL_VERSION=0.X.Y curl -sSf https://get.syncropic.com/spl | sh

# Windows
$env:SPL_VERSION="0.X.Y"; irm https://get.syncropic.com/spl.ps1 | iex

Pinning is useful when you're rolling out a specific version across a fleet, or when you want to test an upgrade before moving everyone off the current one. Versions remain on releases.syncropic.com indefinitely — an old pin keeps working.

Verify

After install, open a new terminal and run:

spl version

Expected output (version number will differ):

spl 0.X.Y

A brief CLI reference:

spl --help

If spl version prints the expected line, you are done with this page. Proceed to First run.

If spl version reports command not found on Linux, your shell has not picked up the PATH update. Either open a new terminal, or source ~/.bashrc (or the rc file your shell actually uses). On Windows, open a fresh PowerShell and verify %LOCALAPPDATA%\Programs\spl is on your user PATH if where.exe spl comes up empty.

Uninstall

Linux

rm ~/.local/bin/spl

Then remove the ~/.local/bin PATH line from your shell rc if you added spl as the reason for it being there. Your ~/.syncro/ data directory is untouched — delete it separately if you want a full wipe (see Reset and uninstall).

Windows

Remove-Item "$env:LOCALAPPDATA\Programs\spl" -Recurse

Then remove %LOCALAPPDATA%\Programs\spl from the user PATH:

$current = [Environment]::GetEnvironmentVariable('Path','User')
$updated = ($current -split ';' | Where-Object { $_ -notmatch 'spl' }) -join ';'
[Environment]::SetEnvironmentVariable('Path', $updated, 'User')

macOS

rm ~/.local/bin/spl

See also

• First run — initialize your identity and ~/.syncro/ tree
• Reset and uninstall — full wipe including data
• Troubleshooting — when install fails or spl version can't find the binary