Documentation menu

// Singularity documentation

The workbench

The workbench is the chrome that remains around your work in Singularity. Its rail switches workspaces, its navigator exposes projects, its deck hosts tabs, and its title bar gathers global commands.

Overview

From left to right, the rail selects a workspace, the navigator shows its tree and tools, and the deck fills the central area. The title bar runs across the top of the window and keeps global actions available.

Singularity workbench annotated with the rail, navigator, deck, and title bar
The four persistent workbench areas around Mission Control.

The rail

Every workspace has a badge in the rail. The active workspace is placed first with a larger badge; the others remain available underneath. An animated outline appears around a badge while an agent is running a ticket in that workspace.

To move a project without opening a dialog, drag it from the navigator onto another workspace badge. The target badge highlights, then the project is assigned to that workspace when dropped.

The deck and its tabs

The deck brings together files, tickets, reviews, terminals, Git cockpits, Git graphs, branches, hooks, settings, Marketplace, and Mission Control. Every document carries a stable identity—such as a file path or ticket ID—so it can never open twice: opening it again activates the existing copy.

Pin a tab to keep it at the start of its strip. Other tabs can be closed with their close control; Mission Control always remains present and cannot be closed.

Splits

Buttons in the tab strip split the active group to the right or downward. Splits can be combined into horizontal, vertical, or nested layouts.

Drag a tab onto another group to move it there, or onto a group edge to create a split at that position. Exactly one group has focus: its outline is accented and new tabs open in it.

Singularity deck split into two side-by-side groups
A horizontal split creates two groups; the right-hand group has focus here.

The title bar

On the right, the title bar provides permanent access to the update center, Marketplace, Settings, and Notifications. Marketplace and Settings open their stable tab in the deck; the update center and notifications open over the workbench.

Collapsible panels

The panel button in the title bar—or ⌘B/Ctrl B—collapses and reopens the navigator sidebar. Its previous width is reused when reopened and its collapsed state is remembered.

The console is now a Terminal surface in the deck: collapse its lower group with the split handle, or close its tab. Because it belongs to the deck, its position among groups is saved with the workspace layout.

What is restored after restart

Singularity saves the complete deck layout per workspace: the split tree, each group’s tabs, the active tab, the focused group, and pinned tabs. When you return to a workspace—including after a restart—its own session is restored without replacing other workspaces’ sessions.

Frequently asked questions

Can I open the same document twice?

No. Every tab has a stable identifier: another open request focuses the existing tab instead.

Is the layout shared by every workspace?

No. Singularity saves a separate deck layout for each workspace.