Vibeleaderboard
Index / tool
Visit github.com
Category
Developer Tools
Rank
No. 1328Tools index
Pricing
Open Source
Type
TOOL
Use case
Deployment & Operations · Security & Identity
Interfaces
Web · CLI · Client SDK
GitHub
88 stars
Latest release
v0.20.0
Date

About

Cordium is a self-hosted sandbox platform on Kubernetes for developers and AI agents. Each sandbox gets an identity through the Octelium zero-trust client, and access proxies hold the upstream credentials and inject them only when a policy allows the request. Sandboxes therefore never store API keys, SSH keys or database passwords, which limits what a compromised sandbox or agent can leak.

What it does

You install it on your own Kubernetes cluster and get workspaces: rootless containers that a person opens in a browser, over SSH or from an editor, and that a program or coding agent drives through a command line tool or a Go client. Each workspace logs in as its own identity on Octelium, a zero-trust access platform from the same authors. When code inside calls a database, an SSH host or a model provider, Octelium's proxy checks policy and attaches the real credential on the way out, so the sandbox itself never holds it.

Why it's ranked here

Most agent sandboxes answer one question, how to run untrusted code safely. Cordium also answers the next one, how that code reaches private systems without a pasted API key, and it does so on plain Kubernetes nodes with no separate virtual machine per sandbox. It is Apache 2.0, aimed at single-tenant self-hosting, and the repository carries a full Go module set for the API server, supervisor, portal and command line tool. Its Go client is built for programs, not just people, which is the audience agent sandboxes serve.

What's good

The Go client treats a failing command as a result, not an error: you get the exit code and captured output, and only a transport failure returns an error. A separate argument-list form passes untrusted input, such as a URL a model produced, without shell interpretation. Output capture is capped at 1 MiB by default and flagged when truncated. Workspace creation returns the handle even if a later startup step fails, so nothing leaks. Egress can be set to default-deny by address range and port, enforced outside the sandbox, and snapshots let you fork a filesystem for parallel agent runs.

Tradeoffs

It is not a standalone tool. Everything runs on top of an Octelium cluster, so adopting it means adopting Octelium's identity, policy and login model as well. Isolation is a rootless container per Kubernetes pod rather than a dedicated virtual machine, which is lighter but a weaker boundary than microVM sandboxes. The execution protocol cannot close standard input on its own, so commands that read until end of file need a terminate-on-exhaustion workaround. File transfer rides the command stream as base64 and needs coreutils or busybox inside the image. The README promises Python, Rust and TypeScript clients, but the only client documented in the repository is Go.

How to use it well

Fit it where a team already runs Kubernetes and wants agents or CI jobs to reach internal databases, SSH hosts or model providers without handing out keys. Start with the single-node quick install, define workspaces as YAML templates with setup tasks, and turn on default-deny egress before letting an agent run untrusted code. From Go, build commands from argument lists for anything a model writes. If you only need a throwaway code interpreter with no access to private systems, a hosted sandbox is less to operate.

Technical notes+

go.work lists fifteen modules, including cluster/apiserver, cluster/supervisor, cluster/portal, cluster/vigil, cluster/workspace, client/cordium and cordium-go. client/cordium/main.go is a thin cobra entry point. cordium-go/client.go wraps an octelium-go Client and opens three generated gRPC clients (MainService, WorkspaceService, ManagementService) on one shared connection, and installs a custom HTTP authorization policy because portal app hostnames use underscores that Octelium's default policy rejects. cordium-go/exec.go sets defaultMaxCaptureBytes to 1 MiB, defaultKillGracePeriod to 10 seconds (the cluster sends SIGTERM then SIGKILL after 5), and ExitCode -1 for signalled commands; WithTerminateOnStdinEOF exists because the protocol has no stdin half-close. cluster/agent/src/index.ts shows the built-in assistant is a TypeScript package exporting an API catalog and client.

Observed

License
Apache 2.0 (LICENSE file in repository root)
Language
Go workspace of fifteen modules, plus a TypeScript package for the built-in agent
Interfaces
Web portal, SSH, cordium CLI, gRPC API with a Go SDK module in the repository
Dependency
Requires an Octelium cluster for identity, policy and credential injection
Platform
Self-hosted on Kubernetes, single-node VM or multi-node cluster; CLI for Linux, macOS and Windows
Isolation model
Rootless container per Kubernetes pod under a supervisor, no per-workspace VM
SDK languages
README names Go, Python, Rust and TypeScript; the Go SDK is documented in cordium-go/README.md

Read from README.md, LICENSE, go.work, cordium-go/README.md, cordium-go/client.go, cordium-go/exec.go, client/cordium/main.go, cluster/agent/src/index.ts.

Tags

sandboxkuberneteszero-trustai-agentsself-hostedsecretless

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.