AI Diagnostic Agent Current

AI uses your own provider key and is currently available without an enforced Pro gate.

Overview

The AI diagnostic agent is a chat sidebar accessible with Cmd+Shift+A. It can call Kubernetes tools to diagnose issues, explain errors, and suggest fixes. It is separate from the base product workflow: Krust remains fully usable for navigation, logs, diff, and terminal work without enabling AI.

Available Tools

10 generic tools that work with any Kubernetes resource type, including CRDs:

Read-Only (auto-execute)

• get_resource — List, get, describe, or YAML for any resource. Supports fieldSelector, labelSelector, and JSONPath for precise field extraction.
• grep_resource — Regex search within resource YAML or pod logs.
• logs — Fetch logs from pods, deployments, jobs, or cronjobs.
• explain_resource — Discover API schema and fields for any resource type. Essential for CRDs.
• filter_resources — Navigate to a resource tab and apply search filters in the UI, showing results directly.
• memory — Persistent memory: store, recall, or forget diagnostic findings across sessions.

Write (requires approval)

• delete_resource — Delete any resource with optional grace period.
• mutate_resource — Restart, scale, cordon, uncordon, or drain.
• apply_manifest — Create or update resources from YAML manifests (opt-in).
• patch_resource — Merge, strategic, or JSON patch with optional dry-run (opt-in).

Human-in-the-Loop

Safety is built into the agent workflow:

• Read operations execute automatically
• Write operations require explicit user approval via an approval card
• Edit/patch tools are opt-in (Settings > AI > Tools)
• Stop button cancels the AI mid-turn at any point
• Max turns configurable (1–50) to limit tool call iterations

Persistent Memory

The agent remembers past incidents across sessions:

• SQLite database with FTS5 full-text search
• Can save and search notes about your cluster
• Recalls past diagnostics and resolutions automatically

Right-Click AI

Right-click any log line and select "Explain with AI" for instant analysis of errors and warnings.

Supported Providers

Bring your own API key. Krust does not bundle model access. Your provider choice and credentials stay under your control.

• Anthropic (Claude)
• OpenAI (GPT)
• Google (Gemini)
• Google Cloud (Vertex AI)
• Local (Ollama)

Setup

1. Open Settings → AI tab
2. Paste your API key
3. Select a provider and model