Documentation
Get started with
KubeIntellect
KubeIntellect is a two-component system: an AI inference backend that runs in the cloud, and a CLI you install locally. Together they let you debug and manage Kubernetes clusters in plain English — from your own terminal.
How the components fit together
Your Machine
kube_q CLI
pip install kube_q
KubeIntellect
AI inference backend
api.kubeintellect.com
Your Cluster
via kubeconfig
stays local · read-only
Your kubeconfig never leaves your machine. Queries go to the inference backend; results come back to your terminal.
Components
KubeIntellect
AI Backend
The inference engine. Hosts the multi-agent AI pipeline that reasons over your cluster state, correlates logs and events, generates diagnoses, and synthesises kubectl commands. Runs at api.kubeintellect.com — you don't need to deploy anything.
- ▸Multi-agent orchestration (planner → executor → verifier)
- ▸Full Kubernetes API coverage — pods, deployments, RBAC, events
- ▸Dynamic tool synthesis per query
- ▸Human-in-the-loop approval for all write operations
kube_q
CLI Client
The terminal client. Install it on your laptop via pip, point it at your kubeconfig, and connect to the KubeIntellect backend. No browser required — everything happens in your terminal.
Install
- ▸Works with any kubeconfig — local, EKS, GKE, AKS, bare-metal
- ▸Connects to api.kubeintellect.com — no local model needed
- ▸Interactive terminal UI with approval prompts
- ▸Requires Python 3.8+
Quick Start
Install the CLI
Install kube_q from PyPI. Requires Python 3.8+.
Connect your cluster
Point kube_q at your kubeconfig. Read-only by default — no cluster-admin required.
Ask a question
Type your question in plain English. KubeIntellect reasons over your cluster state and returns a diagnosis.
Apply the fix
Every write operation requires your explicit approval before anything runs.
Need the full reference?
Complete API reference, configuration options, and advanced usage guides.