Install

Install the kprompt CLI on macOS or Linux from the release script, Homebrew, or source — then verify with kprompt doctor.

Installing is easy; applying is not automatically safe. After install, the fastest demo is the zero-LLM kind walkthrough ($0, no provider key). For natural-language plans, prefer local Ollama or a sandbox cluster, and leave --approve off until you know how plans look.

Homebrew

brew install kprompt/tap/kprompt

Installs the official GitHub Release binary via the kprompt/homebrew-tap formula (macOS and Linux).

Fallback (jsDelivr, pinned tag)

curl -fsSL https://cdn.jsdelivr.net/gh/kprompt/kprompt@v0.9.0/install/install.sh | bash

Use this when kprompt.ai is unreachable or when you want the installer itself pinned to a release tag rather than served from the site.

Supported platforms

OS	Architectures	How to install
macOS	arm64 (Apple Silicon), amd64	Install script or Homebrew
Linux	amd64, arm64	Install script or Homebrew
Windows	amd64, arm64	Build from source with Go

The install script covers macOS and Linux and exits with a clear message on any other OS or architecture. Windows users build from source — the CLI itself is plain Go with no platform-specific cluster access.

Installer options

Variable	Default	Purpose
KPROMPT_VERSION	latest release	Pin a specific tag, for example v0.9.0
KPROMPT_INSTALL_DIR	~/.local/bin	Install elsewhere; system paths usually need sudo bash

Pin a version, or install system-wide

KPROMPT_VERSION=v0.9.0 curl -fsSL https://kprompt.ai/install | bash

# system-wide (root-owned target needs sudo)
KPROMPT_INSTALL_DIR=/usr/local/bin curl -fsSL https://kprompt.ai/install | sudo bash

PATH

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
kprompt version

The installer warns when the target directory is missing from your PATH. Use ~/.bashrc instead of ~/.zshrc on shells that read it.

Verify the install

kprompt version
kprompt doctor          # kubeconfig + LLM key + integrations + Team health
kprompt doctor --json   # same checks, machine-readable

kprompt doctor is the fastest way to confirm a working setup: it checks that a kubeconfig context resolves, that an LLM provider is usable (Ollama needs no key; cloud BYOK needs your provider env var — not a kprompt purchase), which day-2 integrations were detected, and whether optional Team enrollment (kp_… token) is healthy. It exits non-zero when a required check fails, so it also works as a CI preflight.

Upgrade

# script installs: rerun it
curl -fsSL https://kprompt.ai/install | bash

# Homebrew
brew upgrade kprompt/tap/kprompt

Uninstall

rm ~/.local/bin/kprompt        # or: brew uninstall kprompt
rm -rf ~/.kprompt              # config, history, cached policy/credentials

Removing ~/.kprompt clears local config, prompt history, and any cached Team policy or credentials. It never touched your kubeconfig, so cluster access is unaffected.

Troubleshooting

Symptom	Cause	Fix
command not found: kprompt	Install directory is not on PATH	Add ~/.local/bin to PATH, then reload the shell
Cannot write to … (permission denied)	Target directory is root-owned	Keep the default ~/.local/bin, or rerun with sudo bash
No GitHub release found yet	Release lookup failed or was rate-limited	Set KPROMPT_VERSION, or go install ./cmd/kprompt
unsupported os / unsupported arch	Platform outside macOS and Linux on amd64/arm64	Build from source with the Go toolchain

From source

git clone https://github.com/kprompt/kprompt.git
cd kprompt
go install ./cmd/kprompt

Or build into a local path without touching your Go bin directory:

go build -o bin/kprompt ./cmd/kprompt
./bin/kprompt version

Source builds need Go 1.23 or newer. Next: try the $0 walkthrough or Ollama, then walk the plan → approve loop on a sandbox cluster.