Installation

Prerequisites

Binary install path (recommended): no runtime dependency beyond the downloaded binary.

Normative basis: cli_command_reference.md §3.3 and bootstrap_and_initialization_spec.md §4.

v1 deployment note This page describes the v1 local-embedded deployment. Team and enterprise deployments use syndicate-server and differ in endpoint configuration, transport security, and authentication flow.

One-command installation (recommended)

macOS and Linux

Run the following command in your terminal:

curl -fsSL https://install.syndicatecode.ca/install.sh | bash

Windows

Run the following command in PowerShell:

irm https://install.syndicatecode.ca/install.ps1 | iex

The install script downloads the latest binary for your platform and places it on your PATH.

Manual binary download

Download release artifacts from https://gitlab.mikeholownych.com.

Platform	Binary name	Install path convention
Linux x86_64	`syndicate-linux-amd64`	`/usr/local/bin/syndicate`
Linux arm64	`syndicate-linux-arm64`	`/usr/local/bin/syndicate`
macOS x86_64	`syndicate-darwin-amd64`	`/usr/local/bin/syndicate`
macOS arm64	`syndicate-darwin-arm64`	`/usr/local/bin/syndicate`
Windows x86_64	`syndicate-windows-amd64.exe`	`%LOCALAPPDATA%\syndicate\`
Windows arm64	`syndicate-windows-arm64.exe`	`%LOCALAPPDATA%\syndicate\`
FreeBSD x86_64	`syndicate-freebsd-amd64`	`/usr/local/bin/syndicate`
FreeBSD arm64	`syndicate-freebsd-arm64`	`/usr/local/bin/syndicate`

Checksum verification

Release checksums and signatures are published with each artifact.

sha256sum -c checksums.txt --ignore-missing

Optional targeted verification:

sha256sum "<binary-file>"

Compare the digest with the release checksum file before installing.

Shell completion

Generate completion scripts from the binary:

syndicate completion bash
syndicate completion zsh
syndicate completion fish
syndicate completion powershell

Verify installation

syndicate --version

Expected output includes semantic version, commit hash, and build date (cli_command_reference.md §15.4).

Non-guarantee callout A successful install and version check confirm binary health, not model-output correctness or hallucination absence.

Next step

Continue to First Run for workspace initialization, bootstrap sequence, and the first governed workflow.