Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

caliban-operator

The Kubernetes operator for caliban agent workloads: a CalibanTask CRD composed with agent-sandbox.

Written in Rust on kube-rs, the operator composes the Kubernetes SIG agent-sandbox project and reconciles a Workspace + CalibanTask pair of custom resources into a sandboxed agent pod.

A namespaced Workspace holds the durable config: git sources and named model providers, each able to name a Secret. The operator is the sole reader of those Secret values, so prospero only ever handles a reference by name. A CalibanTask points at a Workspace, and the provider it resolves is pinned into its status at admission, so a running task's config cannot shift underneath it. The operator owns the sandbox pod lifecycle, RBAC, and NetworkPolicy; live agent streaming goes straight to caliband instead of through the operator.

The CRDs and their reconcile loops are implemented.

The full guide, architecture decisions, and API reference live on the project site.