Overview

kprompt is The AI Runtime for Kubernetes — an AI-powered runtime that understands your cluster and turns intent into context-aware operations, investigations, and recommendations. Plan before apply. Experimental open-source CLI + optional Observe agent.

Experimental — use carefully

kprompt is early software. Plans can be wrong, incomplete, or unsafe outside the hard-deny rules. Always read the plan (and diffs) before apply. Prefer non-production or kind clusters while you learn the tool. Avoid --approve on unfamiliar prompts. You remain responsible for changes applied with your kubeconfig credentials.

The AI Runtime for Kubernetes means: you state intent; kprompt understands cluster context; it reasons; then it operates, investigates, or recommends — with a reviewable PlanResult before mutate. Investigation and AI SRE packs are one capability lane, not the whole product. Natural-language plans use your kubeconfig and your LLM (local Ollama = $0, or BYOK). Fastest first run: zero-LLM kind Observe walkthrough. Already have a cluster? Adopt (15 min) prefers bind-over-install.

Two surfaces — one contract

Laptop CLI is reactive: you ask, kprompt plans. Optional Observe agent is always-on in a namespace: watch → Incident → gated Slack/webhook — never silent mutate. Same PlanResult DNA if a fix is proposed. Start with Demo, then read Observe agent for Helm.

Visual map of the AI Runtime pipeline, PlanResult contract, investigation CLI packs, and Observe agent: Architecture.

What it is

  • AI Runtime for Kubernetes — understands environment context; turns intent into outcomes
  • Apache-2.0 CLI: Plan → safety → approve → apply loop
  • Optional Observe agent (Helm) — namespace watch → Incident → gated Slack/webhook; no mutate
  • Operate: deploy, scale, rollback, named delete
  • Understand: get/list, explain, logs, describe, dependency graph
  • Investigate: investigate / why / timeline / impact (one capability lane)
  • Analyze / recommend: optimize reports, audit hygiene, score MVP rollup
  • Helm, Argo Workflows, Prometheus, OpenTelemetry, Grafana (when present)
  • Tekton, KEDA, Istio (read-first), Crossplane, Flux/Argo CD GitOps
  • Local history, CI JSON PlanResult, Homebrew install, optional Team login

What it is not (yet)

  • Not a ChatGPT wrapper, kubectl command generator, generic workflow engine, or Kubernetes chatbot
  • Not a monitoring-only AIOps dashboard or incident-only product
  • Not production-hardened or stability-guaranteed
  • Not Autopilot-by-default — optional agent is Observe; Autopilot MVP is propose-only (ADR-0015)
  • Not a Secret-value / external-API Knowledge Graph CMDB — topology KG (service + Ingress/PVC + Secret/CM name-only + ExternalName/env-host/EndpointSlice/NetworkPolicy) ships; Secret values stay out (docs/graph)
  • Not a sandbox / failure-injection Simulation lab — MVP is change preview (plan + blastRadius + impact + Helm dry-run; docs/simulation)
  • Not a full PDB/topology-spread reliability scanner product — use optimize/audit/score MVP; richer scanners are direction
  • Not a Kagent-class multi-agent framework or a K8sGPT fleet scanner
  • Not a replacement for Helm, Argo, Prometheus, kubectl, or operator review
  • Not a Lens/Headlamp replacement — optional local read-only inventory is kprompt-dash (localhost only)
  • Not a hosted multi-cluster / fleet SaaS — multi-context is laptop kubeconfig fan-out only (no kubeconfig upload)
  • Not a public Team signup product — CLI enrollment is opt-in for orgs that already have access
  • Nothing to buy today; Free CLI stays free

Where we deepen next (richer recipes, drift reports, deeper multi-agent reasoning, sandbox Simulation) is documented honestly on Roadmap & vision — shipped vs building vs exploring. Multi-context CLI docs: Multi-cluster. Observe agent install: Observe agent. Runtime closure (Learn · Incident→PlanResult · continuous Coordinator · topology KG · durable memory) shipped in v0.10.

Source of truth for the binary: github.com/kprompt/kprompt. This site mirrors install, safety, providers, and CI docs for operators who land here first.