Downloads and install commands

This page gives you the direct, stable download URL for every SynapseX surface and the exact command that installs it. Copy the row for your platform and you will have SynapseX Desktop or the SynapseX CLI running without hunting through a website.

Where is the download page?

https://synapsex.ai/download 

Two things to know:

• https://synapsex.ai/downloads (plural) is not a page — it returns 404. It is the directory the individual asset URLs below live in, and those resolve normally.
• chat.synapsex.ai/downloads  shows the same list, generated from the same manifest.

SynapseX Desktop 1.17.9

macOS first launch. The macOS build is not notarized, so double-clicking it the first time is blocked by Gatekeeper. Right-click the app in Applications, choose Open, then confirm Open in the dialog. You only do this once.

# Linux
chmod +x synapsex-desktop-x86_64.AppImage
./synapsex-desktop-x86_64.AppImage

Walkthrough with screenshots of the sign-in step: /desktop/install.

SynapseX CLI

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

irm https://synapsex.ai/install.ps1 | iex

The installed executable is named synapsex-code. On macOS and Linux it goes to /usr/local/bin by default; on Windows it goes to %LOCALAPPDATA%\synapsex-code and that directory is added to your user PATH. Override the location with INSTALL_DIR — see /reference/cli-configuration.

Verify the install:

synapsex-code --version

The machine-readable manifest

Every download URL on this page comes from one JSON file, which you can read yourself:

curl -s https://synapsex.ai/downloads/manifest.json

It returns the current version, the date it was published, and a surfaces object with one entry per surface. The top of the real response looks like this:

{
  "version": "1.17.9",
  "updatedAt": "2026-07-19",
  "surfaces": {
    "desktop": {
      "name": "SynapseX Desktop",
      "version": "1.17.9",
      "mac": {
        "available": true,
        "arm64": "https://synapsex.ai/downloads/synapsex-desktop-arm64.dmg",
        "x64": "https://synapsex.ai/downloads/synapsex-desktop-x64.dmg"
      }
    }
  }
}

Two fields are worth scripting against:

• version — the current release. Compare it with synapsex-code --version to decide whether to reinstall.
• surfaces.<name>.available (and, for desktop, surfaces.desktop.<os>.available) — a boolean per surface and per operating system. Read it before showing a download link so you never point a user at something that is not published.

What is not available

Both are marked unavailable in the manifest. There is nothing to install.

How do I update?

Do not use synapsex-code upgrade — it does not work. See /reference/cli-commands.