Working · 6 of 9

Workspaces

A workspace is a client's whole context — folders, hosts, cloud links, snippets and saved layouts — apart from everything else. Every computer starts with Personal.

The workspace menu: each workspace with its hosts and clouds, and its shortcut.

Switching

The chip beside shellden in the title bar names the active workspace in its color. A click lists them all. ⌥⌘1 to ⌥⌘4 switch to the first four.

Switching shows only that workspace's hosts, cloud, snippets and layouts. Other workspaces' tabs keep running, hidden.

A new workspace

New workspace… (the menu, Settings → Workspaces, or a folder's right click → Move to workspace) asks for Name and Colour, then what it Carries its own:

Cloud accounts: the sign-ins ticked are used only here.

AI provider and key: the assistant's provider and its own key.

Permission rules: rules under workspace:<id> in permissions.json.

Production tags: its own list.

Move folders into it brings the ticked folders along. Free has one workspace. Creating more is Pro (Pro: more workspaces), and going back to Free keeps them usable.

Moving and managing

A folder's right click → Move to workspace moves it whole. Move folders here… in the menu brings folders in.

Settings → Workspaces lists each with Switch, Edit and Delete… (its content goes to Personal, which always stays), and the active one's saved layouts.

Gateway: Settings → Gateway → Connected IDEs → Sees chooses Follows the active one or a fixed workspace per IDE.

Saved layouts

⌘K → Save this tab as a layout (Also in adds it to a folder's right click) keeps a tab of panes with each pane's host, folder and startup command (editable). It reopens from ⌘K (LAYOUTS) or a folder's right click → Layouts.

Typing into all panes

Type into all panes, beside the layout buttons, sends the keys to every pane. Panes get an amber ring. With a production pane among them, Return waits for its name (Send to N panes). × drops the line.

Reopening the last session

Settings → General → Reopen the last session brings every workspace back at launch. Tabs and splits and Working folders choose what returns, and Workspace at launch picks the first one. With Production hosts wait for a click a production pane shows Connect first. With it off, ⌘K → Reopen the last session does it once. Commands are never kept.

Sync, export and import

On Pro, workspaces sync. The active one and AI keys stay per computer. An export of Everything carries the active workspace with its name.

← PreviousClient folders Next →The local Linux VM