KubeAgent

Natural language CLI for Kubernetes cluster management

KubeAgent is an AI-powered CLI tool that lets you manage Kubernetes clusters through natural language conversation.

Installation

PyPI (Recommended)

pipx install kubeagent
# or
pip install kubeagent

Homebrew (macOS / Linux)

brew tap Ghostwritten/tap
brew install kubeagent

Docker

# GHCR
docker pull ghcr.io/ghostwritten/kubeagent:latest

# Docker Hub
docker pull ghostwritten/kubeagent:latest

# Run
docker run --rm -v ~/.kube:/home/kubeagent/.kube:ro ghcr.io/ghostwritten/kubeagent

GitHub Releases

Download the latest wheel or source tarball from Releases.

pip install kubeagent-*.whl

Quick Start

# First run triggers setup wizard
kubeagent

# Re-configure anytime
kubeagent init

# Diagnose issues
kubeagent doctor

# Start MCP server
kubeagent mcp start

# Check version
kubeagent --version

Development

# Install with dev dependencies
just install

# Format, lint, test
just check

Architecture

Four-layer architecture: Interface -> Agent -> Capability -> Infrastructure

See AGENTS.md for full specification.

License

MIT