Skip to Content
SynapseX DesktopInstall

Install SynapseX Desktop on macOS, Windows and Linux

This page gets the SynapseX Desktop AI coding agent onto your machine. At the end you will have the app installed and open on its native Code surface, ready to sign in. The current version is 1.17.9.

Where do I download SynapseX Desktop?

The download page is https://synapsex.ai/download .

(Note the singular: https://synapsex.ai/downloads is the asset directory, not a page, and returns a 404. The individual file URLs below do resolve.)

PlatformFile
macOS, Apple Siliconsynapsex-desktop-arm64.dmg 
macOS, Intelsynapsex-desktop-x64.dmg 
Linux, x86_64synapsex-desktop-x86_64.AppImage 
Linux, arm64synapsex-desktop-arm64.AppImage 
Windows, x64synapsex-desktop-windows-x64.zip 

These filenames are stable across releases — only the bytes behind them change — so you can bookmark the one for your platform.

How do I install it on macOS?

  1. Open the .dmg you downloaded.
  2. Drag SynapseX to your Applications folder.
  3. On the first launch only, right-click (or Control-click) SynapseX in Applications, choose Open, then choose Open again in the dialog that appears.

That third step is required because the macOS build is ad-hoc signed and not notarized. If you double-click the app normally the first time, macOS refuses to open it and tells you the developer cannot be verified. That is expected for this build, not a sign that the download is damaged. The right-click → Open path records your approval, and every launch after that is a normal double-click.

How do I install it on Linux?

Make the AppImage executable and run it:

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

On arm64 machines, use synapsex-desktop-arm64.AppImage in both commands. There is no package repository to add and no installer to run.

How do I install it on Windows?

The Windows build is portable — there is no installer.

  1. Unzip synapsex-desktop-windows-x64.zip.
  2. Run SynapseX.exe from the unzipped folder.

Keep the folder wherever you want the app to live; running the .exe from inside it is the whole installation.

How do I update SynapseX Desktop?

Download the current file for your platform again from https://synapsex.ai/download  and replace the installed app with it — replace SynapseX.app on macOS, the AppImage file on Linux, or the unzipped folder on Windows.

There is no automatic update. The app will not notify you about new versions and will not update itself in the background, so re-download when you want a newer build.

How do I confirm the install worked?

Launch the app. It opens directly onto the native Code surface, and the title bar shows the mode pills with Code selected. That is the local coding surface — see Chat, Work and Code in one desktop window for what the other pills do.

You are not signed in yet, so no models are available. Continue to Sign in to SynapseX Desktop.

OverviewSign in