Skip to main content
A workspace is a self-contained setup. It lets you keep personal work, a day job, and individual client projects apart, each with its own sources, skills, statuses, and history. Switch workspaces and Synti loads a different world — different connections, different sessions, different defaults — without anything bleeding across.

​
What a workspace holds

Everything below is scoped per workspace:
  • Sources — the MCP servers, REST APIs, and local filesystems available to that context
  • Skills — reusable instructions invoked by @mention
  • Statuses — the workflow states you organize sessions into
  • Sessions — chat history and conversation records
  • Permissions — optional Explore-mode rules via permissions.json
  • Theme — an optional per-workspace color override
  • Default LLM connection — an optional preferred connection for new sessions

​
Creating and switching

1

Open the workspace dropdown

Click the workspace name in the sidebar.
2

Add a workspace

Choose Add Workspace… and give it a name. Synti creates it with default settings.
3

Switch anytime

Reopen the dropdown and pick a workspace. Synti loads that workspace’s configuration and sessions, and the sidebar shows which one you’re in.

​
Where workspaces live

Each workspace is stored under your Synti config directory:
Inside are subdirectories for sources, skills, statuses, and sessions, plus optional configuration files.

​
How the default LLM connection is chosen

When a new session starts, Synti resolves which connection to use in this order:
  1. A session-specific connection, if one was set
  2. The workspace default (defaults.defaultLlmConnection)
  3. The global default
  4. The first connection in your list
See LLM connections to set these up.

​
Working in multiple windows

You can open several windows at once — commonly one per workspace. When more than one window is open, each title bar shows the workspace that window is viewing, so you can move between contexts with your normal window switcher. Auto-updates preserve your open-window layout: Synti saves which windows and workspaces were open before installing and restores them on relaunch.

​
Remote workspaces

Beyond local workspaces, you can connect to a remote server over a wss:// URL with an authentication token. Remote workspaces appear in the same switcher as local ones and show a connectivity indicator — a normal icon when connected, and an offline icon when the server is unreachable.
The Send to Workspace feature forks a session — creating an independent copy with a conversation summary — between workspaces. Transfer currently works from a local workspace to a remote one. See Sharing.

​
Configuration

Each workspace can carry optional JSON defaults for its LLM connection and color theme, letting you tailor a workspace without touching global settings. Because a workspace is just a directory of configuration, it’s easy to isolate environments — dev, staging, production — or share a setup with a teammate.

Automations

Automations are stored per workspace.

Deep links

Target a specific workspace by ID.