Save and restore local workspaces

Workspace tree

Each workspace contains tabs; each tab contains independent shell sessions. Click a workspace name to fold or unfold its tree. Double-click a workspace, tab, or session name to rename it inline; Enter saves and Escape cancels. The three-dot menu appears on hover or keyboard focus.

A workspace menu includes New tab, Rename, Color, Theme, Settings, and Delete workspace. A tab menu adds sessions to the right or below. A session menu adds a split beside that specific session, opens a new tab in its folder, renames it, detaches it into a new tab, restarts an exited shell, or closes it. Closing live sessions asks for confirmation.

The bottom toolbar contains Terminal, New, Commands, Settings, and the global menu. Click the active Terminal button to collapse the tree into a narrow action rail, then click it again to reopen it. Workspace labels, tabs, and sessions use distinct text colors and a compact hierarchy.

Arrange sessions

Drag a session row or a split session’s header onto the Left, Right, Above, or Below target of another pane. Targets belong to the pane under the pointer. You can keep one full-height session beside two stacked sessions. Drag within the selected workspace; select another workspace before arranging its sessions.

Desktop dividers have a wider grab area and show a resize cursor and grip on hover. Left/right dividers use a horizontal resize cursor; above/below dividers use a vertical one. A junction handle adjusts both directions. Focus a divider and use arrow keys for keyboard resizing. Equalize Splits resets ratios while keeping the shell processes alive.

Local restore

Layouts are stored in ~/Library/Application Support/Qentrah/QH/workspaces.sqlite. The local store records workspaces, tabs, groups, split ratios, focus, colors, names, working folders, window dimensions, sidebar visibility, and the last Settings page. It does not store terminal output or running processes. Reopening creates fresh shells in the saved folders; it does not replay commands. Missing folders fall back to home.

Settings → Storage controls saving, restore, save delay, and the new-workspace limit. Saves are batched and unchanged layouts are skipped. Scrollback is bounded separately in Terminal settings. qh diagnostics validates configuration and shows storage location and the last saved startup time, main-process memory, and session count. These measurements stay local.

Running-tool icons

QH recognizes Pi, Codex, Claude, OpenCode, Gemini, Aider, GitHub CLI, Node.js, and Python where process information is available. It inspects Node wrappers locally and sends only the resolved tool name to the GUI. Detection is best effort; rename the session if a wrapper hides its identity. Custom apps entries have name, literal match, and icon. Supported icons are codex, claude, opencode, pi, gemini, aider, terminal, and shell. Pi, Gemini, and Aider use QH symbols rather than official vendor artwork.