Metadata-Version: 2.4
Name: kubeagent-cli
Version: 1.0.0
Summary: A natural language CLI agent for Kubernetes cluster management
Author: KubeAgent Contributors
License: MIT
License-File: LICENSE
Keywords: agent,ai,cli,k8s,kubernetes
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.12
Requires-Dist: click>=8.1.0
Requires-Dist: kubernetes>=31.0.0
Requires-Dist: litellm>=1.0.0
Requires-Dist: pydantic-ai>=0.2.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.25.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.9.0; extra == 'dev'
Description-Content-Type: text/markdown

# 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)

```bash
pipx install kubeagent
# or
pip install kubeagent
```

### Homebrew (macOS / Linux)

```bash
brew tap Ghostwritten/tap
brew install kubeagent
```

### Docker

```bash
# 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](https://github.com/Ghostwritten/kubeagent/releases).

```bash
pip install kubeagent-*.whl
```

## Quick Start

```bash
# 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

```bash
# Install with dev dependencies
just install

# Format, lint, test
just check
```

## Architecture

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

See [AGENTS.md](AGENTS.md) for full specification.

## License

MIT
