General Settings
The General tab in Settings is organized into four sections: Appearance, Accessibility, Privacy, and General. This page covers the settings not described in their own dedicated pages.
Auto-Select Cluster
Category: General
What it does: When enabled, Kunobi automatically selects a cluster as the active context when you connect to it (or on launch if a cluster is already connected). Favorite clusters are prioritized.
- Enabled (On): The first connected cluster (or your favorite) is auto-selected when Kunobi starts or when you connect a cluster
- Disabled (Off): You manually select the active cluster from the cluster selector
How to change: Settings → General → Auto-Select Cluster toggle
Tip: Combined with Favorite Clusters, this lets you jump straight into your primary cluster every time you open Kunobi.
Auto-Reconnect Retries
Category: General
What it does: Controls how many times Kunobi automatically retries connecting to a cluster when the connection drops unexpectedly.
- 0 — No auto-reconnect; you reconnect manually from the Clusters page
- 1–10 — Kunobi retries the connection up to this many times before giving up and showing an Error status
How to change: Settings → General → Auto-Reconnect Retries (number input)
Tip: A value of 3 is a good default for clusters behind a VPN or with occasional network hiccups.
Keystroke Display
Category: Accessibility
What it does: Shows a visual overlay of the keys you press while using Kunobi. Useful for recording tutorials, demos, or screen captures where viewers need to see what keyboard shortcuts are being used.
Options
- Off — No keystroke display (default)
- Minimal - Subtle display — Shows pressed keys with subtle badges
- Enhanced - Large for visibility — Shows large, prominent badges for maximum visibility
How to change: Settings → General → Keystroke Display dropdown
Tip: Enable Enhanced mode before recording a screen capture or creating documentation for your team.
Terminal Auto-Open
Category: General
What it does: Automatically opens a new terminal session when you open the terminal panel.
- Enabled (On): A terminal tab is created automatically when you toggle the terminal panel open
- Disabled (Off): The terminal panel opens empty; you create terminal sessions manually with +
How to change: Settings → General → Terminal Auto-Open toggle
Auto-Create AI Conversation
Category: General / AI
What it does: Automatically creates a new AI conversation when you switch to the AI tab in the terminal panel.
- Enabled (On): A conversation is started immediately when you open the AI tab
- Disabled (Off): The AI tab opens empty; you start conversations manually
How to change: Settings → General → Auto-Create AI Conversation toggle
See AI & MCP for full AI integration documentation.
Context Watcher Path
Category: General
What it does: Specifies the directory that Kunobi watches for kubeconfig files. By default this is ~/.kube.
Set a custom path if you store kubeconfig files in a different directory or want to watch a shared location.
How to change: Settings → General → Context Watcher Path (text input)
See Context Watcher for recursive mode configuration.