Workspaces Overview

Workspaces help you organize active SSH terminals, SFTP browsers, and local terminal sessions by environment, project, or team. Instead of mixing every session into one place, you can create focused workspaces such as Development, Production, Staging, or Client A.

When to Use Workspaces

• Separate environments — Keep Development and Production sessions in different tabs.
• Group related work — Put all terminals and file browsers for a project in one workspace.
• Reduce mistakes — Make it easier to see whether you are working in a production or non-production context.
• Switch faster — Move between groups of SSH and SFTP sessions without reopening hosts.

Create a Workspace

1. Open Workspaces from the sidebar.
2. Click Add Workspace.
3. Enter a name, for example Development or Production.
4. Click Create.

The new workspace appears as a workspace tab. You can select it any time to see only the sessions assigned to that workspace.

Open SSH in a Workspace

1. Open Hosts.
2. Double-click a host or right-click the host and choose SSH Connect.
3. In the Open SSH in Workspace dialog, choose the workspace where the terminal should open.
4. Click Open.

SSH Bridge switches to Workspaces and opens the SSH terminal inside the selected workspace. If the host needs credentials, SSH Bridge prompts for the username and password before opening the session.

Open SFTP in a Workspace

1. Open Hosts.
2. Right-click a host and choose SFTP Browser.
3. In the Open SFTP in Workspace dialog, choose the workspace where the file browser should open.
4. Click Open.

The SFTP browser opens as a tab inside the selected workspace, keeping file transfer work grouped with the related terminals.

Open Sessions from the Workspace

You can also start work directly from a workspace. Select a workspace, click the plus button in the workspace tab bar, then choose:

• Open Local Terminal — Start a local shell session on this device.
• Open SSH — Choose a host and open an SSH terminal in the current workspace.
• Open SFTP — Choose a host and open an SFTP browser in the current workspace.

Manage Workspaces

• Rename — Right-click a workspace tab and choose Rename. Enter the new workspace name, then click Save.
• Delete — Right-click a workspace tab and choose Delete. SSH Bridge shows a confirmation dialog; click Delete again to remove the workspace.
• Last workspace — SSH Bridge keeps at least one workspace, so the last workspace cannot be deleted.

Example Setup

A common setup is to create two workspaces:

• Development — Open dev servers, staging SFTP sessions, and local terminals here.
• Production — Open production hosts only when you intentionally choose this workspace.

This keeps your daily server work organized and helps prevent accidentally running commands in the wrong environment.