Synaplan Desktop

Synaplan Desktop is a small companion app for Windows, macOS, and Linux. It pairs a computer with your Synaplan workspace so you can chat with your account from a native window — and, when you allow it, run Agent Skills that create files on this computer.

It uses only your Synaplan account. There is no second AI subscription and no vendor dashboard. The models, memories, and knowledge base are the ones you already have.

Preview. Pairing, chat, bundled skills, the folder allowlist, and the local-tools check are working. Signed public installers are not out yet — build from source if you have the client repository. This page will grow as the public download lands.

What you can do

Chat with the models your Synaplan account already has, in a dedicated window.
Run bundled skills that write files locally: a slide deck, an invoice, a calendar invite, a CSV report, and more. See Skills.
Decide the folders a skill may read, and find every generated file in one out-box. See This computer.
See which local tools (Python, Node.js, LibreOffice) the app found. See Check this computer.

How it connects

Synaplan Desktop uses pairing, not a hand-copied API key:

In the Synaplan web app, open Channels → Desktop and choose Pair this computer to get a short code (it expires after ten minutes).
In the desktop app, enter your Synaplan address (for example https://web.synaplan.com or http://localhost:8000 for a local install), the code, and a name for this computer.
The app receives a scoped key — limited to chat, files, and the desktop feature set — and stores it in the operating system's secret store (Windows Credential Manager, macOS Keychain, Linux Secret Service). It is never written to a plain config file.

The paired computer then appears under Channels → Desktop. You can see its last check-in and Disconnect it at any time, which revokes the key.

A leaked or leftover key can only revoke itself — it cannot list or delete other keys, and it cannot reach admin or user-management APIs.

First time a skill runs

The first time you ask the assistant to create a file, the app asks for consent to run skills on this computer. It will only run reviewed skill scripts through the tools it already found — never an arbitrary command, and never a shell. You can change the allowed folders later under This computer.

The screens

Screen	What it is for
Chat	Talk to your Synaplan assistant. Enabled skills can create files; each result appears as a card you can open or reveal in its folder.
Skills	Enable or disable the bundled skills. Only enabled skills are offered to the assistant.
This computer	The out-box, the folders skills may read, and the deny list.
Check this computer	Whether Python, Node.js, and LibreOffice were found, with the exact path and version.

Self-hosted Synaplan

On your own instance the desktop feature is off by default. An administrator turns it on with the DESKTOP_AGENT.ENABLED flag (and chat needs the Messages gateway, MESSAGES_GATEWAY.ENABLED). Until those are on, pairing and chat from the desktop app will not work.

What it is not

Not the Synaplan web app in a wrapper — it runs local skills.
Not tied to one AI vendor — it uses whatever models your account has.
Not a channel that can run arbitrary commands: a skill is a named folder with a SKILL.md and scripts. There is no field through which a shell command could reach your computer.

Troubleshooting

Symptom	What to check
Pairing is refused or the page is missing	Desktop access is off on that Synaplan instance (`DESKTOP_AGENT.ENABLED`).
The code is rejected	Codes expire after ten minutes; create a new one.
Chat says the AI gateway is off	The Messages gateway is disabled (`MESSAGES_GATEWAY.ENABLED`).
Skills do nothing useful	Enable the skill on the Skills screen, allow execution when asked, and confirm Python is found under Check this computer.
An old computer still listed after Disconnect	Disconnect revokes the key. The web list may still show a revoked row until an administrator removes it.