AI Conversations

Kunobi includes a built-in AI assistant that understands Kubernetes. It lives in the terminal panel alongside your shell sessions and has direct access to your live cluster context — namespaces, resources, and status — so it can answer questions with real data instead of generic advice.

Opening the AI Panel

There are two ways to open the AI panel:

Sidebar icon — Click the AI icon in the left vertical navigation bar.
Terminal panel tab — Open the terminal panel (⌘J / Ctrl+J) and switch to the AI tab.

The panel uses a split layout: a conversation list on the left and the active conversation on the right. Drag the divider to resize either side.

Creating a Conversation

Click New Conversation in the conversation list to start a fresh chat.

If you prefer conversations to appear automatically, enable Auto-Create AI Conversation in Settings → General. When turned on, Kunobi creates a new conversation the moment you open the AI tab — no extra click needed.

Each conversation gets an auto-generated title. You can rename it at any time (see Managing Conversations below).

Chatting with the AI

Type your message in the input area at the bottom of the conversation and press Enter to send.

The AI assistant is powered by a specialized Kubernetes agent and uses your connected cluster as context. This means it can reference your actual resources, not just generic documentation. Conversations maintain full history, so you can ask follow-up questions without re-explaining context.

Things the AI can help with:

Troubleshooting pod crashes, CrashLoopBackOff, and OOMKilled events
Explaining resource configurations (Deployments, Services, Ingresses, etc.)
Debugging Flux reconciliation errors and GitRepository sync failures
Diagnosing ArgoCD application sync issues
Answering general Kubernetes concepts and best practices

Managing Conversations

Rename — Click the conversation title in the list to edit it.
Delete — Remove conversations you no longer need.
Switch — Click any conversation in the list to load it in the main panel.

Multiple conversations can exist simultaneously, so you can keep separate threads for different clusters or topics.

AI Usage Limits

AI usage is tracked across three time windows: hourly, daily, and monthly. Your current plan determines the token limits for each window.

Token consumption is visible via the usage popover in the AI panel. When you reach a limit, you can either wait for the next period to reset or upgrade your plan for higher allowances.

Requirements

Signed-in account — AI features require an active Kunobi account. If you are not signed in, the AI panel shows an empty state with a sign-in prompt. See Account & Login for setup instructions.
Internet connection — The AI assistant communicates with cloud-hosted models and requires a network connection.

Setting	Location	What it does
Auto-Create AI Conversation	Settings → General	Automatically starts a new conversation when you open the AI tab
MCP Server	Settings → AI & MCP	Exposes your cluster context to external AI tools like Claude Code and Codex