README
¶
klaus-operator
Kubernetes operator for dynamic management of Klaus instances. Enables platform teams to define reusable agent configurations and lets development teams create on-demand headless AI coding agents via Custom Resource Definitions.
Overview
The klaus-operator manages the full lifecycle of Klaus instances through Kubernetes CRDs:
- KlausInstance -- represents a running Klaus agent with its configuration, workspace, OCI personality reference, and MCP server registration
- KlausMCPServer -- shared MCP server configurations with Secret injection for credentials
Architecture
User IDE --> Muster --> klaus-operator MCP (create/list/delete instances)
|
+----> klaus instance A (prompt/status/stop/result)
+----> klaus instance B (prompt/status/stop/result)
The operator itself exposes an MCP server interface (registered in Muster) with tools for creating, listing, and managing instances. Each managed Klaus instance runs as a separate Deployment with its own PVC workspace.
CRDs
| CRD | Description |
|---|---|
KlausInstance |
A running Klaus agent instance with configuration, workspace, and OCI personality |
KlausMCPServer |
Shared MCP server config with Secret-based credential injection |
Development
See docs/development.md for development setup and contribution guidelines.
License
Apache 2.0 -- see LICENSE.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
api
|
|
|
v1alpha1
Package v1alpha1 contains API Schema definitions for the klaus v1alpha1 API group.
|
Package v1alpha1 contains API Schema definitions for the klaus v1alpha1 API group. |
|
internal
|
|
|
resources
Package resources provides functions to build Kubernetes resources for a KlausInstance, mirroring the patterns from the standalone Helm chart.
|
Package resources provides functions to build Kubernetes resources for a KlausInstance, mirroring the patterns from the standalone Helm chart. |
|
pkg
|
|
Click to show internal directories.
Click to hide internal directories.