Installation

Syntic Code ships as a single native binary for macOS, Linux, and Windows. There are no runtime dependencies — no Node.js, no Python, no Docker required.

System Requirements

Platform	Architectures	Minimum OS
macOS	Apple Silicon (arm64), Intel (x64)	macOS 12 Monterey
Linux	x86_64, arm64	glibc 2.31+ (Ubuntu 20.04, Debian 11, RHEL 9)
Windows	x64	Windows 10 21H2

RAM: 512 MB minimum, 2 GB recommended for large repos. Disk: 80 MB for the binary, additional space for cache.

Install Methods

One-Line Installer (Recommended)

macOS / Linux

curl -fsSL https://syntic.ai/install.sh | sh

Windows (PowerShell)

iwr -useb https://syntic.ai/install.ps1 | iex

Installs to ~/.syntic/bin/syntic. Adds the directory to PATH automatically.

Homebrew (macOS / Linux)

brew install syntic-ai/tap/syntic

Direct Binary Download

Download from github.com/syntic-ai/syntic-code/releases. Pick the build matching your platform:

File	Platform
`syntic-darwin-arm64`	macOS Apple Silicon
`syntic-darwin-x64`	macOS Intel
`syntic-linux-x64`	Linux x86_64
`syntic-linux-arm64`	Linux arm64
`syntic-windows-x64.exe`	Windows x64

Make it executable and place it on your PATH:

chmod +x ~/Downloads/syntic-darwin-arm64
sudo mv ~/Downloads/syntic-darwin-arm64 /usr/local/bin/syntic

Docker

docker run -it --rm -v "$PWD:/workspace" -w /workspace \
  ghcr.io/syntic-ai/syntic:latest

Verify Installation

syntic --version
syntic doctor

syntic doctor runs a diagnostic check (PATH, network, auth, model access) and prints anything misconfigured.

Updating

syntic update

Pulls the latest release and replaces the binary in place. Rollback with syntic update --rollback.

Uninstall

syntic uninstall

Removes the binary, the ~/.syntic directory, and the PATH entry.

Air-Gapped / Offline Install

Enterprise customers can mirror releases internally. See Enterprise → Air-Gapped Deployment for details.

Quickstart CLI Reference