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

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.7.7
File	Size	Uploaded
kaos_cli-0.7.7.tar.gz	91.1 kB	Sep 19, 2026	Details

Built distribution (wheel)

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

Total release size: 188.0 kB

Release files / kaos_cli-0.7.7.tar.gz

Download URL	kaos_cli-0.7.7.tar.gz
Size	91.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`9617afa5deba20870606a5f3a069f5e2605214ccf79112a3ecdf3b92b9369552`
BLAKE2b-256 checksum How to use checksums	`f2c12723526950ca7a727fbf8c0e75e67fdc26bd5ac8aec2462f3505e6edfb2f`
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/2cdb5500cf81b7e4cf40ded095999e564b0668fb

Workflow

Publishing configuration: github.com/axsaucedo/kaos/blob/2cdb5500cf81b7e4cf40ded095999e564b0668fb/.github/workflows/release.yaml
Publishing logs: github.com/axsaucedo/kaos/actions/runs/35424930188/attempts/1

Artifact

Subject: kaos_cli-0.7.7.tar.gz
SHA-256 checksum: 9617afa5deba20870606a5f3a069f5e2605214ccf79112a3ecdf3b92b9369552 Verifying attestations

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

Download URL	kaos_cli-0.7.7-py3-none-any.whl
Size	97.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fbd50fbc391a442454e9ece62d25655b0b126efe0930373513c181d39f62c0c9`
BLAKE2b-256 checksum How to use checksums	`f94c9839a66a4edab583500dc593fc63c5ddc7664aa3d328aabb22752ba121e5`
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/2cdb5500cf81b7e4cf40ded095999e564b0668fb

Workflow

Publishing configuration: github.com/axsaucedo/kaos/blob/2cdb5500cf81b7e4cf40ded095999e564b0668fb/.github/workflows/release.yaml
Publishing logs: github.com/axsaucedo/kaos/actions/runs/35424930188/attempts/1

Artifact

Subject: kaos_cli-0.7.7-py3-none-any.whl
SHA-256 checksum: fbd50fbc391a442454e9ece62d25655b0b126efe0930373513c181d39f62c0c9 Verifying attestations