Workspaces

Workspaces let you organize how you view Kubernetes resources. Each workspace is a named collection of filter presets, column visibility settings, and view configurations — giving you one-click access to the exact view you need.

Built-in Workspaces

Kunobi ships with three built-in workspaces, each tailored to a different workflow:

Workspace	Purpose
General	Curated resource groups (Workloads, Networking, Storage, etc.)
Advanced	Full list of every discovered resource type in the cluster
GitOps	Flux and Argo CD resources organized by their dependency trees

Built-in workspaces are always available and cannot be deleted.

Switching Workspaces

Click the workspace selector in the left sidebar (shows the current workspace name)
Pick a workspace from the popover list
The sidebar and resource view update immediately

You can also press W to open the workspace selector from the keyboard.

Each tab maintains its own workspace selection — switching workspaces in one tab does not affect other tabs.

Creating a Custom Workspace

Open the workspace selector (W)
Click Create workspace... at the bottom of the list
Type a name and press Enter
The new workspace becomes active and appears in the sidebar

Custom workspaces start empty. Add presets (see below) to build up your saved views.

Filter Presets

Presets capture a snapshot of your current view state so you can restore it later with a single click. Each preset saves:

Kind pills — which resource types are selected
Namespace filters — active namespace restrictions
Search and field filters — any text, regex, or field filters applied
Column visibility — which columns are shown or hidden
View mode — the current layout (Table, Graph, Split)

Saving a Preset

Set up the filters, columns, and view mode you want to keep
Click the Save Preset button (bookmark icon) in the filter bar
Enter a name (or accept the auto-generated name like "Preset 1")
Choose which workspace to save it in — or create a new workspace on the fly
Click Save

Quick save: Press ⌘S (macOS) / Ctrl+S (Windows/Linux) to save the current state as a new preset in the active workspace without opening a dialog.

Restoring a Preset

Switch to the workspace that contains the preset (if not already active)
The sidebar shows all presets for the active workspace — click one to restore it
Filters, column visibility, and view mode are applied instantly

You can also search presets by name, resource kind, or namespace using the search bar at the top of the preset list.

View Modes

Each tab can display resources in one of four layouts. View mode is saved with presets so you can switch between layouts by restoring different presets.

Mode	Description
Table	Traditional resource table with sortable columns
Graph	Interactive dependency graph visualization
Split (Vertical)	Side-by-side table and graph
Split (Horizontal)	Stacked table and graph

Switch view modes from the view mode selector in the toolbar. The selection is remembered per tab and per view.

Pinning Workspaces

Pin frequently-used workspaces to the vertical navigation bar for one-click access.

Open the workspace selector (W)
Hover over a workspace to reveal the pin icon
Click the pin icon — a pinned workspace button appears in the vertical nav bar

Click a pinned workspace button to navigate to K8s Resources and activate that workspace in one step. Click it again to toggle the left sidebar. To unpin, open the workspace selector and click the pin icon again.

Default K8s Workspace

Set one workspace as the default so it activates automatically when you click K8s Resources in the nav bar. Open the workspace selector, hover over a built-in workspace (General or Advanced), and click the server icon.

Managing Workspaces and Presets

Rename or Delete a Workspace

Open the workspace selector
Hover over a custom workspace and click the settings (gear) icon
In the dialog, rename or delete the workspace

Viewing Presets in a Workspace

Select a custom workspace to see its presets listed in the sidebar. Each preset shows its name and a settings icon.

Rename or Delete a Preset

In the sidebar preset list, hover over a preset and click the settings (gear) icon
Rename or delete the preset from the dialog

Deleting a workspace removes all of its presets. This cannot be undone.

Per-Tab State

Kunobi uses browser-like tabs, and each tab maintains independent state:

Workspace selection — each tab can use a different workspace
Active filters — kind pills, namespace filters, search, field filters
Scroll position and selection — resource selection is tab-scoped
View mode — Table, Graph, or Split layout

Closing a tab cleans up all of its state. Opening a new tab starts with the default workspace.

Keyboard Shortcuts

Action	macOS	Windows/Linux
Open workspace selector	`W`	`W`
Pin/unpin current workspace	`⇧P`	`Shift+P`
Quick save preset	`⌘S`	`Ctrl+S`

See Keybindings to customize any of these shortcuts.