KAOS CLI

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

Installation

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

Usage

Start UI Proxy

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

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:

# 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

kaos version

Development

# Run tests
pytest

# Run directly
python -m kaos_cli.main ui

Release files for kaos-cli 0.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kaos-cli 0.8.0
File	Size	Uploaded
kaos_cli-0.8.0.tar.gz	94.2 kB	Sep 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for kaos-cli 0.8.0
File	Interpreter	ABI	Platform	Reset
kaos_cli-0.8.0-py3-none-any.whl 99.0 kB Sep 19, 2026	Python 3	none	any	Details

Total release size: 193.3 kB

Release files / kaos_cli-0.8.0.tar.gz

Download URL	kaos_cli-0.8.0.tar.gz
Size	94.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`1333a58d08e554f39ea24aa6ca7bffe5c55c47f52fd329d186ec4d67388b8606`
BLAKE2b-256 checksum How to use checksums	`435b81d228c650f6a88dcc0d7846419e896755b03258206c320c65052f07ec8a`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/axsaucedo/kaos
Publishing commit: github.com/axsaucedo/kaos/tree/562544e2c1ee83c83c6b7a86aa4ac9f71e176f3a

Workflow

Publishing configuration: github.com/axsaucedo/kaos/blob/562544e2c1ee83c83c6b7a86aa4ac9f71e176f3a/.github/workflows/release.yaml
Publishing logs: github.com/axsaucedo/kaos/actions/runs/35444396465/attempts/1

Artifact

Subject: kaos_cli-0.8.0.tar.gz
SHA-256 checksum: 1333a58d08e554f39ea24aa6ca7bffe5c55c47f52fd329d186ec4d67388b8606 Verifying attestations

Release files / kaos_cli-0.8.0-py3-none-any.whl

Download URL	kaos_cli-0.8.0-py3-none-any.whl
Size	99.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8d58ffc6972eb5313bb3477fa3922412ae943f25c1a8f3b41295c69de1dc46d2`
BLAKE2b-256 checksum How to use checksums	`7ff0663adba8dc153a855401826b87b3d7b0455ed37c173452fe9d7b911cced4`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/axsaucedo/kaos
Publishing commit: github.com/axsaucedo/kaos/tree/562544e2c1ee83c83c6b7a86aa4ac9f71e176f3a

Workflow

Publishing configuration: github.com/axsaucedo/kaos/blob/562544e2c1ee83c83c6b7a86aa4ac9f71e176f3a/.github/workflows/release.yaml
Publishing logs: github.com/axsaucedo/kaos/actions/runs/35444396465/attempts/1

Artifact

Subject: kaos_cli-0.8.0-py3-none-any.whl
SHA-256 checksum: 8d58ffc6972eb5313bb3477fa3922412ae943f25c1a8f3b41295c69de1dc46d2 Verifying attestations