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.
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
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.
| CRD | Description |
|---|---|
KlausInstance |
A running Klaus agent instance with configuration, workspace, and OCI personality |
KlausMCPServer |
Shared MCP server config with Secret-based credential injection |
See docs/development.md for development setup and contribution guidelines.
Apache 2.0 -- see LICENSE.