Quickstart

Kubeconfig, config file, API key, and your first prompts — carefully.

Start on a disposable cluster (kind, minikube, or a dedicated sandbox). Do not point an unreviewed --approve flow at production until you have practiced the plan → approve loop.

1. Cluster access

kubectl config current-context
kubectl get ns

2. Save defaults (no secrets)

kprompt config set provider gemini
kprompt config set model gemini-2.0-flash
kprompt config set namespace default
kprompt config

Config lives at ~/.kprompt/config.yaml. It never stores API keys — only whether a key is set or unset in the environment.

3. Export an API key

export KPROMPT_GEMINI_API_KEY="..."
# or OPENAI / ANTHROPIC / GROQ / … — see Providers

4. Prompt

kprompt "list deployments"
kprompt "scale api to 3"          # plan + y/N on a TTY
kprompt "scale api to 3" --approve --wait
kprompt "explain why api is crashing"

History

kprompt history
kprompt history rerun
kprompt history rerun 3 --approve