Skip to content
Synoec

Desktop app

One window for conversations, browsing and investigation.

The desktop app is an Electron client of the shared Synoec engine. It shares configuration, history and permissions with the CLI. The left rail, Platforms, switches between four areas in the same window:

Area Rail detail Use it for
Synoec Conversations & projects Chats, projects, Marketplace, Local AI, Context and Usage. The sidebar heading reads Synoec | Makerspace
Ergon Agent companies Companies of agent seats and their org chart. See Ergon
Agora Browse & research An in-app browser with its own Browser chat. See Agora
Lysis Investigate & understand Reverse-engineering investigations. See Lysis

The bottom of the rail holds the Profile picker (Chat Profile: choose a Profile, or open the Persona chooser from its Persona link) and Settings. Switching areas keeps live chats and drafts in every area.

The chats of one workspace share one engine; each turn carries its own chat’s Profile and model, so chats on different models run side by side. Nothing moves a chat off the Profile or connection you selected: a provider that cannot answer says so in the chat (see Operations).

Closing the window keeps Synoec running, so chats and local services carry on. On macOS, click the Dock icon to bring the window back, and quit with ⌘Q or the Dock icon’s Quit. On Windows, the close button minimizes Synoec to the taskbar; right-click its taskbar icon and choose Close window to quit (Alt+F4 quits too). Synoec has no notification-area icon of its own. The Local AI service does, because it keeps running after Synoec closes.

A project chat with the Workbench open, showing the session and changed files

Limits

Section titled “Limits”
  • macOS on Apple Silicon is the main tested platform. Windows builds have testing releases and were exercised on a Windows 11 VM; its Bash sandbox is a confinement tier, not the Mac’s, and clean-machine Windows journeys are still limited.
  • Mac source builds are signed for local use (an Apple Development identity when the Mac has one, otherwise ad-hoc) and are not notarized.
  • Assembled Mac checks have covered project edits with executed checks, inline approval and Stop, provider model activation across settings reopen, Agora on real sites, Usage periods and Context review. They do not prove every website, clean-machine installation on either platform, full keyboard and screen-reader journeys, performance, or notarization.
  • There is no command palette.
  • There is no Workflows or Automations page. Schedules and recipes run from the CLI (synoec automation, synoec recipe); see Tasks and subthreads.
  • Mermaid diagrams and math (math/latex fences and $$ … $$ blocks) render in a sandboxed frame; Source shows the original. A diagram that fails to render stays as code. Inline $…$ math is not rendered, and of other reply HTML only <br> and <kbd> render.
Section titled “Related”

Getting started · CLI · Tasks and subthreads · Providers and models

Decisions behind this page: 0147, 0186, 0187, 0199, 0200, 0214, 0216, 0218, 0228, 0229, 0232, 0237, 0239, 0240, 0244, 0256, 0269, 0270, 0271, 0272, 0274, 0280, 0281, 0284 — see the decisions index.