Filtering & Search

Kunobi's filter bar lets you quickly narrow down any resource list using a simple but powerful syntax. You can filter by namespace, field values, regex patterns, or exact matches — and save your favorite filters as presets.

Opening the Filter Bar

• Click the search/filter icon in the toolbar, or
• Press ⌘F (macOS) / Ctrl+F (Windows/Linux) to focus the filter input

Filter Syntax

Plain Text (Name Filter)

Type any text to filter resources by name (case-insensitive substring match):

nginx

Shows all resources whose name contains nginx.

---

Namespace Filter — @

Prefix a namespace name with @ to filter by namespace:

@default

Shows only resources in the default namespace.

@kube-system

Shows only resources in the kube-system namespace.

---

Field Filter — .

Use dot notation to filter by any field in the resource spec or status:

.status.phase=Running

Shows only resources where status.phase equals Running.

.spec.replicas=3

Shows only resources with exactly 3 replicas configured.

Operators supported:

• = — exact value match
• != — value does not match
• > / < — numeric comparison (for integer fields)

---

Regex Filter — /

Prefix your pattern with / to use a regular expression:

/^web-.*

Shows resources whose name starts with web-.

/-(prod|staging)-

Shows resources whose name contains -prod- or -staging-.

---

Exact Match — "

Wrap a value in double quotes for an exact match (useful when the name contains special characters):

"my-service"

Shows only the resource named exactly my-service.

---

Combining Filters

You can combine multiple filter tokens by separating them with a space. All conditions are ANDed:

@production .status.phase=Running nginx

Shows all resources in the production namespace, with status.phase=Running, whose name contains nginx.

---

Filter Presets

Save frequently-used filter combinations as named presets so you can apply them with a single click.

Saving a Preset

1. Set up the filters you want to save using the filter bar
2. Click the Save Preset button (bookmark icon) next to the filter bar, or use the quick-save action
3. Enter a name for the preset
4. Click Save

Loading a Preset

1. Click the Presets dropdown next to the filter bar
2. Select a preset from the list
3. The filter bar updates instantly and the resource list is filtered

Managing Presets

• Click the edit icon next to a preset to rename it
• Click the delete icon to remove a preset
• Presets are stored locally and persist across sessions

---

Search in Discovery Sidebar

The left sidebar includes a Discovery Search to quickly jump between resource types:

1. Click the search icon at the top of the sidebar, or
2. Press ⌘K to open the command palette, then type a resource name

This is useful when you want to quickly switch from viewing Deployments to viewing Services, ConfigMaps, or any other resource type.

---

Cluster & Context Search

On the Clusters page, use the search box (⌘F) to filter clusters by context name or kubeconfig path.

---

Tips

• Filters are per-page — filters set on the K8s Drilldown page don't affect the Flux page
• Filters are cleared on navigation — switching resource types resets the filter bar
• Use presets for filters you apply regularly (e.g., showing only Running pods in production)
• The regex filter is powerful for complex name patterns across large clusters