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.1

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.1
File	Size	Uploaded
kaos_cli-0.8.1.tar.gz	94.3 kB	Sep 26, 2026	Details

Built distribution (wheel)

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

Total release size: 193.3 kB

Release files / kaos_cli-0.8.1.tar.gz

Download URL	kaos_cli-0.8.1.tar.gz
Size	94.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`ee6723ee3ee2e5a7dde0207eaddcd5b5f55011305934776b35b7efbdc1bbff70`
BLAKE2b-256 checksum How to use checksums	`eab2972e97c8dad6d612cf4e86540a2e8e2209291903dc3d8c0009906e66955e`
Upload date	Sep 26, 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/a91b3df7ee585ec18353d8c8ef39478efb011d25

Workflow

Publishing configuration: github.com/axsaucedo/kaos/blob/a91b3df7ee585ec18353d8c8ef39478efb011d25/.github/workflows/release.yaml
Publishing logs: github.com/axsaucedo/kaos/actions/runs/36217698529/attempts/1

Artifact

Subject: kaos_cli-0.8.1.tar.gz
SHA-256 checksum: ee6723ee3ee2e5a7dde0207eaddcd5b5f55011305934776b35b7efbdc1bbff70 Verifying attestations

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

Download URL	kaos_cli-0.8.1-py3-none-any.whl
Size	99.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8aa55a44ff761f53b72c2d309d7c6601c9ac4a15f7aa7e3d7cc55bed987d9711`
BLAKE2b-256 checksum How to use checksums	`7f2400f030af198066c4522d7ed0cf7c15724f80e355caf46bcfc8f931e50b29`
Upload date	Sep 26, 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/a91b3df7ee585ec18353d8c8ef39478efb011d25

Workflow

Publishing configuration: github.com/axsaucedo/kaos/blob/a91b3df7ee585ec18353d8c8ef39478efb011d25/.github/workflows/release.yaml
Publishing logs: github.com/axsaucedo/kaos/actions/runs/36217698529/attempts/1

Artifact

Subject: kaos_cli-0.8.1-py3-none-any.whl
SHA-256 checksum: 8aa55a44ff761f53b72c2d309d7c6601c9ac4a15f7aa7e3d7cc55bed987d9711 Verifying attestations