pptx

Synaplan Desktop

Pair a computer with your Synaplan workspace and run Agent Skills locally.

Synaplan  ·  Website  ·  Live app  ·  Docs  ·  Discord  ·  Synamail

---

A small native app for Windows, macOS, and Linux. It pairs with your Synaplan workspace, chats through your existing account, and runs installed Agent Skills on this computer — under a folder allowlist, with no shell and no network.

It uses only your Synaplan account. There is no second AI subscription and no vendor dashboard. The API key lives in the OS secret store (Windows Credential Manager, macOS Keychain, Linux Secret Service), never in a config file.

Unsigned 1.0 preview. Pair, chat, install or remove skills, check local tools, and run web-queued jobs on a running (optionally autostarted) app. Build from source. Signed public download comes after signing (notarization is still deferred). Unsigned installers are for internal testing only.

What it is (and is not)

It is a Tauri 2 + Vue 3 desktop client. It talks to Synaplan over the Anthropic-compatible Messages gateway (/v1/messages) and the desktop pairing API. Enabled skills run locally as {program, args[]} against allowlisted interpreters (Python, Node, LibreOffice). A message that names a file or the project folder can list, read and write files without a skill. Running a program still needs an enabled skill and your consent.

It is not an Electron wrap of the Synaplan web app, and it never embeds web.synaplan.com in a WebView. It is not a general-purpose shell host: skills that need bash, curl, or the network are refused.

Pair this computer

1. In Synaplan, open Manage → Channels → Synaplan Desktop and choose Pair this computer (the instance needs Desktop access on — DESKTOP_AGENT.ENABLED).
2. In the app, paste the server address from that dialog (for a local install that is the API, for example http://localhost:8000, not the web page port) and the short code.
3. The app stores a scoped key in the OS secret store. Disconnect the computer from the web UI at any time to revoke it.

Docs

Bundled skills

These ship with the app (skills/bundled/). Eleven need Python 3 (standard library only). pptx needs python-pptx and stays blocked until that import works — the app never runs pip. See docs/BUNDLED_SKILLS.md.

Install extra skills

On Skills, choose From a folder, From a zip, or From a GitHub address, review the file list, then confirm. Many community Agent Skills assume an unrestricted shell or network — Synaplan Desktop will refuse those. See docs/SKILLS.md.

Developer quick start

Prerequisites are installed by the setup script for your OS:

# Linux
bash scripts/setup-linux.sh

# macOS
bash scripts/setup-macos.sh

# Windows (PowerShell)
./scripts/setup-windows.ps1

Then run the app with the start script for your OS — it checks the toolchain (Node 22+, Rust, the platform libraries, node_modules) and names anything missing before it launches npm run tauri dev:

./start-linux.sh            # Linux
./start-macos.command       # macOS (also double-clickable in Finder)
./start-windows.ps1         # Windows (PowerShell)

Add --check (Windows: -Check) to run only the checks. On headless Linux or WSL there is no system keyring; ./start-linux.sh --plaintext-key opts into the dev-only key file (see docs/DEVELOPMENT.md). npm run tauri dev still works directly once everything is installed.

Try it offline (no Synaplan server)

npm run mock-server          # starts http://localhost:8788
npm run tauri dev            # pair against http://localhost:8788 with any code

The mock accepts pairing, lists a mock model, and streams a short chat reply.

See docs/DEVELOPMENT.md for the dev loop and docs/PLATFORMS.md for per-OS build prerequisites.

Run the full local gate (mirrors CI) before every commit:

make ci-local

Architecture

• src/ — Vue 3 + TypeScript UI. Talks to Rust only through src/services/tauri.ts.
• src-tauri/synaplan-core/ — platform-independent, unit-tested Rust core (paths, secret store, pairing, SSE parsing, config, frozen contract types).
• src-tauri/synaplan-core/src/platform/ — the only place OS differences live (app_dirs, secret_store).
• src-tauri/src/ — the thin Tauri shell (commands + events).
• skills/bundled/ — the twelve Agent Skills that ship with the app (eleven stdlib + a blocked-until-ready pptx).

License

Apache License 2.0 — see LICENSE. Copyright 2026 metadist GmbH.

Status

Unsigned 1.0. Pairing, chat, skill install, doctor, tray, and the poll loop work. Build from source with the setup scripts above. Signed public installers are not published yet. On unsigned macOS, turning on “Start when I sign in” may show a Login Items warning — that is expected.