BROWSE

Resource workspace

KubeRich uses a keyboard-driven resource workspace built with original Python/Textual code. The shared header, input area and navigation trail keep resource views in a consistent frame.

The default k9s theme has a black background, cyan tables/frames/selection, yellow metadata labels/navigation, blue shortcut keys and white headings. Explicit Textual themes remain supported. Select it for one invocation:

KUBERICH_THEME=k9s uv run kuberich

The top header shows context, cluster/user aliases, namespace, connection state and installed application version, without credentials. View-specific shortcuts show implemented pod, namespace, container and log actions. Inputs sit above resources. The dedicated : bar shows the selected completion suffix next to typed text, in muted italic styling; it never opens a dropdown over resources. Tab accepts it and Up/Down cycles the bounded local candidates. Plain Enter submits literal input; Enter after deliberate cycling accepts that candidate. Typing makes no API requests; suggestions still use the session name catalogue. The command row sits inside its own rectangular border. Below 16 terminal rows, it keeps side borders so the table retains usable height; all views reserve the same four ordinary/two compact interaction rows.

The bottom trail identifies the current view and Escape action. Escape first leaves an input, then clears an active filter, then returns to the parent view. Pods, contexts, namespaces, containers and logs share the same frame margins, header columns and reserved interaction/footer rows at a fixed terminal size. Clicking controls or changing focus does not move that frame. View actions change while their header columns retain a fixed row count. Container/log views retain captured pod identity and parent viewport. Embedded shells retain their existing target frame, remote-key routing and cleanup.

Live namespaces

Bare :ns, :namespace, :namespaces, n or F3 open a normal workspace table. It reads real Namespace objects through the owned per-session LIST/WATCH service. NAME/STATUS/AGE columns use UID selection and ascending name order; unknown status/time appears as Unknown / —.

/ filters name/status using the same literal and bounded re: syntax as pods. Enter returns to the table; Escape there clears the filter.
Enter opens pods in the selected namespace. The namespace filter does not filter pods. Escape from the unfiltered pod table restores the namespace filter, UID selection and viewport.
0 or All namespaces opens all pods. It is a scope action, not a fabricated resource row with a fake UID.
j/k, arrows, PageUp/PageDown and g/G navigate namespace rows.
:ns NAME, :ns *, :po NAME, :po * still select pods directly. A pod filter stays active when changing scope from the pod view.
:po opens pods in the current scope. :back / :forward retain resource kind, context, namespace, filter and viewport.

Only the active resource is watched. Switches invalidate old results, await old watches/projection/filter workers and clear obsolete navigation targets. Denied listing is an error rather than an empty table; directly entering an allowed namespace still works. Temporary failures retain the last snapshot with stale status. Recreated namespaces have distinct UID selection.

Inspection uses existing captured-UID details/YAML/events services. Logs and shells require a pod; namespace mutations remain planned.

Local contexts

Bare :ctx, :context, :contexts, c or F2 shows a workspace table with NAME/CLUSTER/AUTHINFO/NAMESPACE and * for the selected session. These entries come from the loaded kubeconfig catalogue, not a Kubernetes resource endpoint. Aliases are rendered as redacted literal text; no credential bodies or API URLs are displayed. / filters these columns with the existing bounded literal/ regex semantics. Browsing makes no authentication request and rewrites no file.

Enter connects to the exact selected name, including case/spaces, and opens pods. Switching keeps the existing owned cancellation and generation checks. Escape first clears the filter, then restores the preceding pod/namespace view and its filter/viewport. Back/forward also retains the context table state. Direct :ctx NAME still connects immediately; context tables have no resource YAML/details/events because their rows are local configuration. Scoped :ns NAME, :ns * and :po NAME from contexts open pods with their own filter; they preserve the context query/cursor for returning to the catalogue.

Container details

Enter on a pod shows NAME, TYPE (App/Init/Sidecar), READY, STATE, RESTARTS, IMAGE, PROBES(R:L:S), CPU REQ/LIM, MEM REQ/LIM and PORTS. Status is joined by container name, not list position. Missing readiness/restart data is —, absent state is Unknown, and waiting/termination reasons such as CrashLoopBackOff/OOMKilled remain visible. Configured probes use readiness:liveness:startup order and on/off labels. Ports include declared name/number/protocol, with a bounded list and … when longer.

CPU/MEM are specification requests/limits in Kubernetes quantity notation, with — for undeclared quantities. They are not live usage. Values come from the captured pod snapshot; reopen to refresh. Horizontal arrows/Home/End reveal wide columns. Enter/l logs and s/x shell retain the captured UID/container and parent cursor/scroll state. Live container refresh, ephemeral debug containers and usage metrics are planned.

Sizes and remaining work

At 70+ columns the header uses six rows. Narrow terminals use four rows, omitting cluster/user aliases and the logo. Below 16 rows the three-row context/namespace/ state header preserves room for resources/inputs. Container hints and log controls remain available; help contains secondary shortcuts. NO_COLOR retains textual cues.

The upper-right brand is an original five-row KubeRich ASCII logo from 120 columns, or a compact wordmark at 70–119 columns. Resizing changes only the mark's reserved width, keeping the shared view geometry consistent at each terminal size. The project, installed version label and CLI remain KubeRich/kuberich.

--headless hides the shortcut/logo header, --logoless hides its brand and --crumbsless hides identity/navigation bars. Log z hides the header/route and frame, preserving search, controls and stream ownership.

The header shows the actual installed version. Optional real release notices, custom/live/context themes and Kubernetes-version/CPU/memory presentation are planned. Clipboard receipt depends on the host terminal. This release does not establish full K9s parity.

Behavior references: K9s commands, K9s skins, Textual themes.

Built from the maintained source guide on GitHub.