Navigation & Keyboard Shortcuts

Kubius is designed for keyboard-first navigation. You rarely need the mouse to move between resources.

Sidebar

The sidebar groups resources by category - Features, Cluster, Workloads, ArgoCD, Configuration, Controllers, Tasks, Networking, Policy, Storage, Access, RBAC, and API Resources. Sections appear only when the cluster has at least one resource of that kind in the current namespace scope, so a small cluster shows a short list.

The Features section, pinned at the top, holds the views that aren’t backed by a single K8s resource type - the Dashboard and Right-Sizing. Coloured badges next to the Right-Sizing row indicate work in flight (blue: running analyses, green: unread completed ones).

Use the arrow keys to move between resource types when the sidebar has focus.

The Filter box above the sections lets you narrow the list by name. The System toggle controls visibility of cluster-internal namespaces in counts and lists.

API Resources

Kubius gives first-class sidebar rows to the common Kubernetes kinds (and to provider CRDs it knows about - Gateway API, ArgoCD, GKE, EKS, AKS). Everything else served by your cluster - like kubectl api-resources would list - lives in the collapsible API Resources group at the bottom of the sidebar, grouped by API group. This is where you’ll find CRDs Kubius has no dedicated screen for.

• Counts load in the background. Right after connecting, Kubius counts each discovered type and shows the number next to its row. Counting is non-blocking - you can open and browse a type before its count arrives.
• Empty types are hidden. Once a type has been counted, it disappears from the list if your cluster has zero of them (so kinds like BlockAffinity that exist in the API but have no instances don’t clutter the list). Types still being counted stay visible. Counts and visibility honour the current namespace scope.
• Lists are snapshots, not live. Unlike first-class rows (which stream live updates), opening a type under API Resources does a one-shot fetch. A banner at the top of the list says so, with a Refresh button beside it - click it to re-fetch the current state. Counts in the sidebar are likewise a point-in-time snapshot from connect time.

Opening an item drills into a generic detail view with its YAML, related resources, events, and the same right-click Delete / Copy kubectl actions as any other resource.

Namespace selector

The namespace selector is a multi-select. Click it (in the toolbar or the sidebar) to open a searchable sheet with an All Namespaces master checkbox and a checkbox per namespace. The button summarises the current choice - “All Namespaces”, a single namespace name, “N namespaces”, or “No namespaces”.

• All Namespaces (default) - watch cluster-wide and show everything.
• One or more namespaces - tick the ones you want; lists, counts and the node Pods tab narrow to those namespaces.
• None (hit Clear) - show only non-namespaced items.

Changing the scope may restart the watch streams (counts can briefly drop to zero while new lists arrive); toggling between several namespaces re-filters instantly with no reload.

When you scope to specific namespaces, the sidebar hides anything outside them:

• Resource types with zero items in the selection disappear (e.g. ConfigMap won’t show a row if there are no ConfigMaps in those namespaces)
• Cluster-scoped types (Node, PersistentVolume, StorageClass, ClusterRole, ClusterRoleBinding) are hidden entirely - they don’t belong to any namespace
• ArgoCD apps are filtered to those living in the selected namespaces
• Switch back to All Namespaces to see everything again

Command palette - ⌘K

Press ⌘K to open the command palette. Start typing and you’ll get matches across pods, deployments, services, StatefulSets, DaemonSets, ConfigMaps, secrets, ingresses, nodes, namespaces, and ArgoCD applications. Up to eight results per type are shown.

• ↑ / ↓ - navigate results
• ↩ - open the highlighted result in the detail panel
• ⎋ - close the palette

Filter / search - ⌘F

⌘F focuses the nearest text field on screen:

• In a resource list, it focuses the filter box at the top
• In a log view, it focuses the search box
• In the YAML viewer, it focuses the inline search

If you’re already typing in a filter, ⌘F does nothing (so you don’t lose what you’ve typed).

Back / forward - ⌘[ and ⌘]

Browser-style history. Every time you select a resource, switch a tab inside a detail view, or type into the log search, your navigation state is recorded. ⌘[ or ⌘← goes back, ⌘] or ⌘→ goes forward.

The history is namespace-aware - jumping back to a resource you viewed in a different namespace flips the namespace picker back automatically.

Deleted resources are skipped and pruned from the history, so future presses don’t try to re-open them.

Right-Sizing selections are recorded too - drilling Pod → Deployment → Right-Sizing → Deployment and walking back works exactly as you’d expect.

History is per-session - a full app exit wipes the back/forward stack. Within a session, switching between clusters restores each one’s stack as you return.

Separately, Kubius remembers the last view you were on per cluster and restores it on the next launch - namespace scope, the sidebar selection, and the open resource. This works for any kind, including items opened from the API Resources group (Kubius re-fetches the object by its API path to rebuild the view). If that resource was deleted while the app was closed, you simply land on its list instead.

Keyboard shortcut map - ?

Press ? at any time to overlay a list of every shortcut. ⎋ dismisses it.

All shortcuts

Key	Action
⌘K	Open command palette
⌘F	Focus filter / search
⌘⇧?	Open this help
?	Show shortcut map
↩	Open selected resource in window
⎋	Close palette / overlay
⌘R	Refresh resources
⌘⇧R	Reload kubeconfig contexts
⌘[ / ⌘←	Navigate back
⌘] / ⌘→	Navigate forward
⌘,	Open preferences
⌘W	Close current window
⌘N	(Disabled - Kubius is single-main-window)