# Workspaces

## Overview

<figure><img src="/files/9ObQRSwBYlKGpGYELKr2" alt=""><figcaption></figcaption></figure>

Workspaces group multiple terminal sessions into one focused environment. They help you work across multiple servers to deploy, validate changes across environments, or compare logs without rebuilding the same setup each time.

Inside a workspace, you can:

* **Organize work** by intent: deploy, incident, investigation
* Switch between [Focus mode](#focus-mode) and [Split view](#split-view)
* [Broadcast](#command-broadcast-mode) the same input to multiple sessions

You can save a workspace as a reusable **workspace template**. When you reopen it, Termius restores it to the saved state.

**Workspace templates capture:**

* Included connections
* Tab names
* Layout configuration
* Working directories
* Running commands at the time of saving

{% hint style="info" %}
Workspaces are currently available on **macOS**, **Windows**, and **Linux**.
{% endhint %}

***

## Create a workspace template

You need at least **two sessions** to create a workspace. You can use remote hosts or local terminals.

{% tabs %}
{% tab title="In New Tab" %}
To create a **workspace template** from **New Tab**:

1. Open **New Tab** with `Ctrl/Cmd + T`, or click **`+`** in the tab bar

   <figure><img src="/files/FJUNB8D4n43nQoGtXZxY" alt=""><figcaption></figcaption></figure>
2. Select two or more connections from the **Recent connections** list

   <figure><img src="/files/0IEtyQMyyKC3R77OOpLi" alt=""><figcaption></figcaption></figure>
3. Click `Create a workspace`
4. Enter a name and press `Enter`

   <figure><img src="/files/0ImMVkEwOYd2qgZ2314D" alt=""><figcaption></figcaption></figure>
5. Double-click the saved workspace template to open it in [Focus mode](#focus-mode)

   <figure><img src="/files/B3jca24IAjrJ7LZIDCqo" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="In Terminal" %}
To create a **workspace template** from **Terminal**:

1. Open one connection. Then drag another connection onto its tab. Termius creates a new workspace in [Split view](#split-view)

   <figure><img src="/files/hkmlToWM7I9VXzUaDsT5" alt=""><figcaption></figcaption></figure>
2. Save the workspace as a template:

   <figure><img src="/files/OCLoLZP8szC3qivFh6YR" alt=""><figcaption></figcaption></figure>

   1. Click the **gray dot** on the workspace tab, or
   2. Press `Ctrl/Cmd + S`
      {% endtab %}
      {% endtabs %}

***

## Focus mode and Split view

A workspace has two view modes: [Focus mode](#focus-mode) and [Split view](#split-view). You can switch between them at any time without interrupting the sessions inside.

{% tabs %}
{% tab title="Focus mode" %}

<figure><img src="/files/xvP2DiSaPiwKlIspvuMf" alt=""><figcaption></figcaption></figure>

**Focus mode** shows one terminal in the main view. The other terminals stay visible in the side panel.

#### Switch to Focus mode

<figure><img src="/files/ZsSX4L7lKD6GwI1bfwx8" alt=""><figcaption></figcaption></figure>

In **Split view**, click the `view mode` icon in the terminal pane. Or press `Ctrl/Cmd + Shift + M`.

[Save](#keyboard-shortcuts) the workspace template.
{% endtab %}

{% tab title="Split view" %}

<figure><img src="/files/zCqgV25OMJLdgk0fdEko" alt=""><figcaption></figcaption></figure>

**Split view** shows all terminals in the workspace at once.

Use it to watch logs across hosts, compare outputs, or coordinate changes when you need the full picture.

{% hint style="info" %}
You can add up to **16 terminals** in Split view.
{% endhint %}

#### Adjust the layout

<figure><img src="/files/FCwP5kssmDjPo1yPINpp" alt=""><figcaption></figcaption></figure>

1. Drag the dividers between terminal panes to resize them
2. Drag a terminal pane to change its position
3. [Save](#keyboard-shortcuts) the workspace template

#### Switch to Split view

<figure><img src="/files/rOgVUkaWNGNxTQdCyiyf" alt=""><figcaption></figcaption></figure>

In **Focus mode**, click the `view mode` icon in the side panel. Or press `Ctrl/Cmd + Shift + M`.

[Save](#keyboard-shortcuts) the workspace template.
{% endtab %}
{% endtabs %}

## Save and update workspace templates

When you open a workspace from a workspace template, Termius tracks any changes you make to it.

The **gray dot** on the tab shows unsaved changes. If you close the workspace without saving, the workspace template stays unchanged.

### Save a workspace template

<figure><img src="/files/OCLoLZP8szC3qivFh6YR" alt=""><figcaption></figcaption></figure>

To save or update a **workspace template**:

* Click the **gray dot** on the workspace tab, or
* Press `Ctrl/Cmd + S`

#### What counts as a change

* **View mode:** Switching between [Focus mode](#focus-mode) and [Split view](#split-view)
* **Renaming:** Changing the name of a workspace template or a terminal tab
* **Terminal pane layout:** Adjusting terminal pane sizes or positions in Split view
* **Tab order:** Reordering tabs in the side panel in Focus mode
* **Working directory:** Changing the active directory in one or more sessions
* **Running commands:** The active commands differ from the last saved state

### Rename a workspace template

{% tabs %}
{% tab title="In New Tab" %}

<figure><img src="/files/3lyrFVQw0ZiG5ltDoK4A" alt=""><figcaption></figcaption></figure>

To rename a **workspace template** in **New Tab**:

1. Open **New Tab** with `Ctrl/Cmd + T`, or click **`+`** in the tab bar
2. Hover over the workspace template and click the `pen` icon
3. Enter a new name and press `Enter`
   {% endtab %}

{% tab title="In Terminal" %}

<figure><img src="/files/vYzrwJw6mmkYdz1097kH" alt=""><figcaption></figcaption></figure>

To rename a **workspace template** in **Terminal**:

1. Right-click a workspace tab
2. Click `Rename`
3. Enter a new name and press `Enter`
4. [Save](#keyboard-shortcuts) the workspace template
   {% endtab %}
   {% endtabs %}

### Rename a terminal tab in a workspace template

<figure><img src="/files/2cyCmIQiW39nCOt8IpE3" alt=""><figcaption></figcaption></figure>

You can give a terminal tab a custom name in a workspace. This changes only the tab name in the workspace. It does not change the original hostname.

1. Right-click a terminal tab
2. Click `Rename`
3. Enter a new name and press `Enter`
4. [Save](#keyboard-shortcuts) the workspace template

### Working directories and running commands

<figure><img src="/files/DNczYJAioJja9rcFSYYl" alt=""><figcaption></figcaption></figure>

When [Autocomplete](/terminal/autocomplete-and-shell-integration.md) is enabled, Termius tracks the **working directory** and **active command** for each session in a workspace.

This state appears on the terminal tab. You can save it in the workspace template. When you reopen the template, each session returns to the same directory and command state.

If Autocomplete is disabled, the working directory and running command are not displayed or restored.

***

## Command broadcast mode

In a workspace, you can enable **Command broadcast mode** to send the same input to every active terminal. Use it for checks, config changes, and state validation across hosts.

### Enable broadcast mode

{% tabs %}
{% tab title="In Focus mode" %}

<figure><img src="/files/eUnrqvVj3JCz9ateRXHi" alt=""><figcaption></figcaption></figure>

To enable **Command broadcast mode** in **Focus mode**, click the `Broadcast icon` in the side panel.

The selected terminal stays active for input. Termius sends your input to all active terminals in the workspace.
{% endtab %}

{% tab title="In Split view" %}

<figure><img src="/files/ABJR0BW4ByQBvCbYwZVG" alt=""><figcaption></figcaption></figure>

To enable **Command broadcast mode** in **Split view**, click the `Broadcast icon` in the terminal pane.

A solid frame highlights the **main input terminal**. Termius sends your input to all active terminals in the workspace.
{% endtab %}
{% endtabs %}

***

## Session status indicators

<figure><img src="/files/GEsuPs7lEyBiIm5NRnws" alt=""><figcaption></figcaption></figure>

Each tab shows a dot that reflects the session state. In **Focus mode**, it appears in the side panel. In **Split view**, it appears on the terminal pane header.

🟢 **Green:** Shows unread output in the terminal

🟡 **Yellow:** Requires your input, such as a password, confirmation, or prompt

🔴 **Red:** Indicates an error in the terminal or a failed connection

***

## Keyboard shortcuts

|                                |                        |
| ------------------------------ | ---------------------- |
| Switch Focus mode / Split view | `Ctrl/Cmd + Shift + M` |
| Toggle Broadcast mode          | `Ctrl/Cmd + B`         |
| Save workspace template        | `Ctrl/Cmd + S`         |

{% hint style="info" %}
If you need to customize keyboard shortcuts, you can do so in `Termius > Settings > Shortcuts`.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.termius.com/terminal/workspaces.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.