Workspaces
A workspace is NEXUS's top-level container for sessions, agents, and files — each one keeps its own layout, so switching between them never bleeds one workspace's arrangement into another's. Two separate controls switch which workspace is active, and a third lets you move something from one workspace into another.
The workspace selector
A small color-and-name capsule in the title bar opens the workspace selector. Each workspace listed there expands into its own menu:
| Item | What it does |
|---|---|
| (switch) | Makes that workspace active. |
| New Session / New Bit Page | Creates one, directly inside that workspace. |
| Close All Sessions | Closes every session in that workspace. |
| Workspace Settings | Opens its contextual settings — name, color, and grid-column count. |
| Rename | Renames the workspace inline. |
| Delete | Removes the workspace, once more than one exists. |
New Workspace creates another one, alongside the list of existing ones.
The tab strip
A separate row of colored pill tabs sits atop the Sessions sidebar — one pill per workspace. Unlike the selector, the tab strip exists only to switch and filter which workspace's sessions the sidebar shows; it has no menu of its own. Use the selector above when you need to rename, recolor, or delete a workspace, and the tab strip for quickly switching between the ones you already have open.
An All tab merges every workspace's content for browsing, without changing which workspace new content actually lands in — it's a view for looking across workspaces, not a workspace itself.
Drag-and-drop reassignment
Dragging a session (a terminal or a canvas preview) from the sidebar onto a workspace's pill in the tab strip reassigns that session to the workspace you dropped it on. A bit page dragged the same way behaves differently: dropping it onto an agent attaches it to that agent as a file, rather than moving it between workspaces — see Capabilities & skills for attached files.
Why layout is scoped per workspace
Each workspace keeps its own pane arrangement, last-active session, and sidebar state, so switching to one restores exactly what you left there — nothing from another workspace carries over. See Layout persistence for exactly what's remembered and restored across a relaunch.
Where to go next
- Layout Persistence — what's remembered per workspace, and at the window level, across relaunch.
- Pane Types — the sessions and previews a workspace actually holds.
- Settings reference — the Name, Color, Grid Columns, and Delete Workspace fields behind Workspace Settings.