Workspaces

A workspace is a named set of tabs and panes — one per project, for example. Switch between workspaces without closing anything, and find them again the way you left them when you restart Cogno.

Open the workspace panel with Ctrl+Alt+W (Command+Control+W on macOS).

Use it

To…	Do this
Create a workspace	Click + (“New workspace”), enter a name and pick a color. It starts as a copy of your current tabs and panes.
Switch to a workspace	Click its tile, or select it with the arrow keys and press Enter
Rename or recolor	Hover the tile and click the pencil
Reorder	Drag a tile
Close	Click the x on an open workspace. Its terminals are closed; the workspace stays in the list.
Delete	Hover the tile, click the trash, then confirm with the check mark

Switching keeps everything running. The terminals of the workspace you leave continue in the background — a build keeps building. Only closing or deleting a workspace ends its processes. If one of its terminals is still busy, Cogno asks first.

The name of the active workspace is shown in the title bar. With several workspaces open, it becomes a menu to switch between them.

Switch with the keyboard

Shortcut	Switches to
Ctrl+Alt+1 … 9 (Command+Alt+1 … 9 on macOS)	the first to ninth workspace, in the order of the panel
Ctrl+Alt+0 (Command+Alt+0 on macOS)	the default workspace

A tile’s tooltip shows its shortcut.

The default workspace

The first tile, Default Workspace, is always there. It is where Cogno starts, and where you land when you close the workspace you are in. It cannot be renamed, moved, closed or deleted.

Several windows

A new window (new_window) always starts fresh, in its own empty default workspace. Only the window Cogno started with brings back the last session.

A workspace is open in one window at a time. If you open a workspace that another window already shows, Cogno brings that window to the front instead.

What comes back after a restart

Cogno saves your workspaces on its own — a moment after the terminal goes quiet, when you switch workspaces, and when you quit. On the next launch the workspaces that were open are open again.

Restored	Not restored
Tabs with their order, titles and colors	Running programs — every terminal starts a fresh shell
Panes with their splits and sizes	Environment variables and shell state
The shell profile and working directory of every pane
The terminal output, above a thin line that marks where the old session ends

Nothing is run again. A command that was still running when you quit is simply gone.

To restore the layout but start with empty terminals:

terminal.restore.scrollback = false

To limit how much output is kept per terminal (the default is 1000 lines):

terminal.restore.max_lines = 5000

Delete what was saved

To get rid of everything Cogno has stored for restoring — for example because old terminal output keeps coming back — run Delete Restore Data from the command palette (action clear_restore_data).

After a confirmation Cogno deletes the saved terminal output, the record of which workspaces were open, and the saved state of the default workspace. The terminals that are open stay as they are, and the next launch starts fresh. From then on Cogno saves as usual again.

Your workspaces and their layouts are kept.

Saving by hand instead

With terminal.restore.enabled = false, Cogno brings nothing back: every launch starts in a fresh default workspace, and no terminal output is kept.

Your workspaces stay in the list. A workspace whose layout differs from its saved state is marked as changed, and a Save workspace button appears on its tile. Opening a workspace builds it from the layout you last saved.

Settings

• terminal.restore.enabled, .scrollback, .max_lines — what Cogno saves and restores
• feature.workspace.mode — set to off to remove workspaces, including the side-menu entry and shortcuts.
• feature.workspace.order — position in the side menu.

To change the shortcuts, rebind open_workspace, select_workspace_1 … select_workspace_9 and select_workspace_default, see Keybindings.