synaplan-desktop
Synaplan Desktop — pair a computer with your Synaplan workspace and run Agent Skills locally (Windows, macOS, Linux)
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/metadist--synaplan-desktop)HTML
<a href="/listings/metadist--synaplan-desktop"><img src="/api/listings/metadist--synaplan-desktop/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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`](docs/SKILLS.md).
| OS | Skills directory | | -- | ---------------- | | Windows | `%LOCALAPPDATA%\Synaplan\Desktop\skills\` | | macOS | `~/Library/Application Support/com.synaplan.desktop/skills/` | | Linux | `$XDG_DATA_HOME/synaplan-desktop/skills/` or `~/.local/share/synaplan-desktop/skills/` |
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 178 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- # Synaplan Desktop
- **Pair a computer with your Synaplan workspace and run Agent Skills locally.**
- [Synaplan](https://github.com/metadist/synaplan) · [Website](https://www.synaplan.com) · [Live app](https://web.synaplan.com) · [Docs](https://docs.synaplan.com/desktop) · [Discord](https://discord.com/invite/kQB3eDjWfF) · [Synamail](https://github.com/metadist/Synamail)
- [](LICENSE)
- [](https://github.com/metadist/synaplan-desktop)
- [](https://docs.synaplan.com/desktop)
- <br />
- <img
- src="docs/screenshot.png"
- alt="Synaplan Desktop: a project home with chat, notes, files and the composer"
- width="920"
- />
- </div>
- ---
- A small native app for **Windows, macOS, and Linux**. It pairs with your
- [Synaplan](https://github.com/metadist/synaplan) workspace, chats through your
- existing account, and runs installed [Agent Skills](https://agentskills.io/specification)
- 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
- | Topic | Link |
- | ----- | ---- |
- | Overview and pairing | [docs.synaplan.com/desktop](https://docs.synaplan.com/desktop) |
- | Skills | [docs.synaplan.com/desktop-skills](https://docs.synaplan.com/desktop-skills) |
- | Folders and the out-box | [docs.synaplan.com/desktop-folders](https://docs.synaplan.com/desktop-folders) |
- | Local tools (doctor) | [docs.synaplan.com/desktop-tools](https://docs.synaplan.com/desktop-tools) |
- | In-repo skills catalog | [`docs/SKILLS.md`](docs/SKILLS.md) |
- | Business use-case films | [`docs/demos/README.md`](docs/demos/README.md) |
- ## 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`](docs/BUNDLED_SKILLS.md).
- | Skill | What it creates |
- | ----- | --------------- |
- | **csv-insights** | Markdown profile of a CSV (rows, fill rates, numeric and category summaries) |
- | **email-draft** | Unsent `.eml` draft for Outlook, Apple Mail, or Thunderbird |
- | **web-report** | Standalone HTML page from Markdown or plain text |
- | **slides** | Self-contained HTML presentation (arrow keys; no PowerPoint) |
- | **chart** | Bar or line chart from a CSV, as SVG inside a standalone HTML page |
- | **data-table** | Searchable, sortable HTML table from a CSV |
- | **calendar-event** | `.ics` invite for Outlook, Apple Calendar, or Google Calendar |
- | **vcard** | `.vcf` contact card for any address book |
- | **json-csv** | JSON array of objects ⇄ CSV |
- | **invoice** | Print-ready HTML invoice from a JSON spec |
- | **hello-files** | Tiny example that writes `hello.txt` into the out-box |
- | **pptx** | PowerPoint deck (blocked until `python-pptx` is installed) |
- ## 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`](docs/SKILLS.md).
- | OS | Skills directory |
- | -- | ---------------- |
- | Windows | `%LOCALAPPDATA%\Synaplan\Desktop\skills\` |
- | macOS | `~/Library/Application Support/com.synaplan.desktop/skills/` |
- | Linux | `$XDG_DATA_HOME/synaplan-desktop/skills/` or `~/.local/share/synaplan-desktop/skills/` |
- ## Developer quick start
- Prerequisites are installed by the setup script for your OS:
- ```bash
- # 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`:
- ```bash
- ./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)
- ```bash
- 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`](docs/DEVELOPMENT.md) for the dev loop and
- [`docs/PLATFORMS.md`](docs/PLATFORMS.md) for per-OS build prerequisites.
- Run the full local gate (mirrors CI) before every commit:
- ```bash
- 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`](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.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.