Workspaces

The sidebar shows sessions grouped by workspace. Press a workspace row to show or hide its sessions. Which ones are folded is remembered for each machine and travels with Sync.

Each session row has a dot for its state, the session name on its first line and the destination on its second, so the name has the whole width.

• Dot: green when connected, an amber ring while connecting or reconnecting, faint when it has exited. A filled amber dot means an unread notification
• Second line: the destination while connected. While connecting, reconnecting, after it exits, or when there is a problem, the state takes that place ("reconnecting 2/5", "exited 255", and so on)
• Unread notifications: a session whose program (Claude Code, Codex, ...) sent a notification shows its text under the destination until you open the session. The count in the "Workspaces" heading, such as Unread 2, opens the unread sessions in sidebar order
• … and ×: with a mouse, they appear only on the selected row and the row under the pointer

Built-in workspaces

Two workspaces always exist and cannot be deleted. Both can be renamed.

Workspace	What goes in	Shown
Main	Sessions opened from the app, including Home and SFTP	Yes
Agents	Sessions opened with sshc terminal create	Hidden

Connections that LLMs and scripts open with sshc terminal create go into Agents and stay out of the sidebar. --workspace puts them in another workspace instead (see CLI).

Actions

• Create: + next to the Workspaces heading (New workspace)
• See hidden workspaces: the heading's … → Show hidden workspaces. Hidden ones appear dimmed.
• Open a session: + on a workspace row. New session below the tree opens in the selected session's workspace.
• Move: drag a session onto another workspace's row, or onto a session inside it. Dropped on the row, it goes to the end of that workspace; dropped on a session, it goes just before it. Folded and empty workspaces take drops too. A session's … → Move to workspace does the same, putting it at the end
• Reorder sessions: drag a session onto another session of the same workspace to put it just before that one, or onto the workspace's row to put it at the end. A session's … → Move up / Move down does the same (the way on a phone)
• Reorder workspaces: drag a workspace's row onto another workspace. Dropped on its upper half, it goes before that workspace; on its lower half, after it. A workspace's … → Move up / Move down does the same (the way on a phone). Main and Agents can be moved too
• A workspace's …: rename, hide or show, move up or down, send a command, delete

Deleting a workspace closes nothing: its sessions move to Main.

What is stored

The engine keeps workspace names, their order, and whether each is hidden in ~/.ssh/sshc/workspaces.json. The file is excluded from encrypted sync.

• Because the engine holds the order, every browser and machine that opens it sees the same order.
• A new workspace goes to the end, or just before Agents when Agents is last.
• Which session is in which workspace, and the order of the sessions in it, live in the engine's memory, like the sessions themselves. So every browser and machine that opens the engine, or uses it for a remote session, sees the sessions in the same order, and reloading the page keeps it.
• When the engine stops cleanly, the record kept for reopening includes each session's workspace and order, so sessions reopened on the next start return to the same workspace in the same order.

Use Split view to arrange sessions on screen. Split arrangements are not saved.