Metadata-Version: 2.4
Name: kaos-cli
Version: 0.2.6
Summary: CLI for KAOS (K8s Agent Orchestration System)
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.9.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: starlette>=0.37.0
Requires-Dist: kubernetes>=29.0.0
Requires-Dist: pyyaml>=6.0.0

# KAOS CLI

Command-line interface for KAOS (K8s Agent Orchestration System).

## Installation

```bash
cd kaos-cli
uv sync
source .venv/bin/activate
```

## Usage

### Start UI Proxy

Start a CORS-enabled proxy to the Kubernetes API server:

```bash
kaos ui
```

This starts a local proxy on port 8010 that:
- Proxies requests to the Kubernetes API using your kubeconfig credentials
- Adds CORS headers to enable browser-based access
- Exposes the `mcp-session-id` header for MCP protocol support

Options:
- `--k8s-url`: Override the Kubernetes API URL (default: from kubeconfig)
- `--expose-port`: Port to expose the proxy on (default: 8010)
- `--namespace`, `-n`: Initial namespace to display in the UI (default: "default")
- `--no-browser`: Don't automatically open the browser

Example:
```bash
# Use default settings
kaos ui

# Custom port
kaos ui --expose-port 9000

# Start with a specific namespace
kaos ui --namespace kaos-system

# Custom K8s URL
kaos ui --k8s-url https://my-cluster:6443
```

### Version

```bash
kaos version
```

## Development

```bash
# Run tests
pytest

# Run directly
python -m kaos_cli.main ui
```
