> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synti.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces

> Keep separate configurations — sources, skills, statuses, sessions, and defaults — for different contexts.

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

<Steps>
  <Step title="Open the workspace dropdown">
    Click the workspace name in the sidebar.
  </Step>

  <Step title="Add a workspace">
    Choose **Add Workspace…** and give it a name. Synti creates it with default settings.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Where workspaces live

Each workspace is stored under your Synti config directory:

```text theme={null}
~/.synti/workspaces/{workspace-id}/
```

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](/reference/config/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.

<Note>
  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](/go-further/sharing).
</Note>

## 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.

## Related

<CardGroup cols={2}>
  <Card title="Automations" icon="robot" href="/automations/overview">
    Automations are stored per workspace.
  </Card>

  <Card title="Deep links" icon="link" href="/go-further/deeplinks">
    Target a specific workspace by ID.
  </Card>
</CardGroup>