OpenShell is an open-source runtime, from NVIDIA, that sandboxes autonomous AI agents so they run with only the permissions they need, enforced by declarative policies that block unauthorized file access, data exfiltrationdata exfiltrationMoving data out of a system or organization without authorization. It can happen through network transfers, removable media or other channels., and uncontrolled network activity. It is a command-line tool, installed with a shell script or via PyPI, with the sandboxes themselves backed by Docker, Podman, Kubernetes, or experimental MicroVMs, and it also ships a Helm chart for cluster deployment. It's aimed at teams building or operating AI agents who need to constrain what those agents can touch, rather than at traditional SOCSOCA security operations center, the team or function that monitors threats, investigates alerts and coordinates incident response. Its work can be internal, outsourced or shared. or red-team work, fitting into the broader ai-security category of controlling agent behavior at runtime. With 116 contributors, over 2,300 commits and 68 releases in the past year, and a release just 16 days ago, it is under active, fast-moving development, though its own status badge still marks it alpha.
OpenShell runs autonomous AI agents in policy-controlled sandboxes with isolated filesystem, network, and credential access.
Which of my agents just tried to read a file or reach a host they had no business touching?
every sandboxed action is checked against the declarative policy at the moment it happens, and the denied file, network, or credential attempt shows up in the sandbox logs rather than silently succeeding
Is an agent quietly sending my data somewhere it shouldn't?
outbound network activity from the sandbox is restricted to what the policy allows, so exfiltration attempts show up as blocked connections instead of completed transfers
Can I let an agent run a build or training job without baking my API keys into its image?
credentials and config can be injected into the sandbox as environment variables at creation or exec time, kept out of the agent's filesystem and image
What did an agent actually do during a run I wasn't watching?
sandbox activity is recorded and viewable through the command-line and terminal interface, or exported as OCSF JSON records for review after the fact
Which inference calls from my agents are leaving my own infrastructure?
routing can be pointed at local or self-hosted backends instead of external providers, keeping prompt and response traffic inside environments the operator controls
Do two agents running the same policy actually get the same permissions?
policies are declarative YAML tied to the sandbox's profile, so the same file settles what any agent under it can touch regardless of which one is running
51 capabilities
across 8 areas
· 5 backed by code, an API document or a real run
Built from OpenShell's releases, docs, README and our own runs.
“Seen” marks the month we first spotted a release the vendor didn't date.
Group names and tags are our labels.
OpenShell covers 1 of the 6 ai evaluation and governance capabilities we track.
OpenShell covers 1 of the 3 runtime security capabilities we track.
What OpenShell offers you
Command-line interface10
Client SDKs2
Kubernetes-native deployment2
CI/CD pipeline integration1
gRPC API support1
JSON data export1
Multi-tenant management1
OIDC SSO1
Plugin API support1
Plugin system1
Role-based access control1
Show
No capabilities match.
+Sandbox Orchestration and Lifecycle6 capabilitiesOpenShell's core function is creating and running sandboxes across local, container, and Kubernetes environments. This area covers how sandboxes are defined, launched, configured, and torn down.▸
+Kubernetes deployment and topology configurationshippedControls how sandboxes are deployed on Kubernetes, including storage configuration, sidecar topology, and volume targeting.22 releases · 1 other source · first seen May 2026▸
Also counts toward: Kubernetes-native deployment
release
22 total
Adds supervisor_topology = "gateway" under [openshell.drivers.kubernetes] to enable an experimental shared supervisor that hosts many sandboxes in one process as a pool that can take over a failed supervisor's sandboxes, with supervisor.replicas to set pool capacity.
v0.1.6 · Oct 2026
· source
· release history
Enables a Kubernetes shared supervisor (experimental) with supervisor_topology = "gateway" under [openshell.drivers.kubernetes], consolidating many sandboxes into one process with configurable replica count via supervisor.replicas.
v0.1.6 · Oct 2026
· source
· release history
On Kubernetes, sandbox templates that set pod annotations or labels are now rejected unless an operator allowlists the keys with allowed_pod_annotations and allowed_pod_labels in [openshell.drivers.kubernetes].
v0.1.5 · Oct 2026
· source
· release history
Adds allowed_pod_annotations and allowed_pod_labels settings in [openshell.drivers.kubernetes] to allowlist pod annotation and label keys used in sandbox templates.
v0.1.5 · Oct 2026
· source
· release history
Adds server.dataStorageSize and server.dataStorageClass Helm values to configure the gateway data PVC.
v0.1.5 · Oct 2026
· source
· release history
Makes the e2e:kubernetes target work transparently on OpenShift
v0.1.0 · Sep 2026
· source
· release history
docs
Kernel-enforced sandbox runtime for autonomous AI agents that applies formally verified filesystem, network, and process policies.
+Local sandbox CLI runnerverifiedLets users run sandboxes locally with control over distro selection, SSH forwarding, runtime profiles, and whether disk state is kept after shutdown.12 releases · 8 other sources · first seen May 2026▸
release
12 total
Adds enable_bind_mounts = true setting in [openshell.drivers.vm] to allow MicroVM sandboxes to mount host directories through virtiofs; supports up to 3 mounts on x86_64 or 32 on aarch64 (QEMU-backed and GPU launches are not supported).
v0.1.5 · Oct 2026
· source
· release history
Adds CLI label creation and filtering for providers.
v0.1.4 · Oct 2026
· source
· release history
Adds snap gateway as a user service by default, removing the need for system-level privileges on snap-based installs.
v0.1.4 · Oct 2026
· source
· release history
Adds feat(cli): detach sandbox sessions with Ctrl-D — pressing Ctrl-D inside a sandbox session now detaches cleanly rather than terminating.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(cli): detach sandbox sessions with Ctrl-D — press Ctrl-D to detach from a running sandbox session without terminating it.
v0.1.3 · Oct 2026
· source
· release history
Add --no-login-shell flag to sandbox exec to skip shell startup files on execution.
v0.1.0 · Sep 2026
· source
· release history
command line
--stable — Previous stable tag override.
v0.1.0-pre.2 · Sep 2026
· command-line history
--list — List distros and configurations
v0.0.95 · Jul 2026
· command-line history
--ssh-port — Use a specific loopback SSH forwarding port
v0.0.95 · Jul 2026
· command-line history
--keep — Preserve the disk overlay and logs after shutdown
v0.0.95 · Jul 2026
· command-line history
--with — Apply docker, podman, or selinux; repeatable
v0.0.95 · Jul 2026
· command-line history
example
Detach from a running sandbox session without terminating it — useful in CI or long-running agent workflows where you want to leave the sandbox alive.$ openshell sandbox connect my-sandbox # Inside the session, press Ctrl-D to detach cleanly
v0.1.3 · Oct 2026
· source
Upload multiple files into a sandbox at creation time instead of running separate upload steps.$ openShell sandbox create --upload ./model.bin --upload ./config.yaml --upload ./secrets.env
v0.0.56 · Jun 2026
· source
+Gateway callback and compute coordinationshippedCoordinates dynamically between running sandboxes and the gateway control plane through callback listener negotiation.6 releases · first seen Mar 2026▸
release
Gateway mutation locks are now scoped per workspace and sandbox with bounded waits, preventing bursts of supervisor reconnects from queuing behind a single fleet-wide lock.
v0.1.5 · Oct 2026
· source
· release history
Adds gateway callback listener negotiation in the compute layer, enabling the gateway to coordinate callback endpoints with sandbox compute drivers.
v0.0.97 · Aug 2026
· source
· release history
feat(compute): negotiate gateway callback listeners for dynamic service discovery
v0.0.97 · Aug 2026
· source
· release history
Adds gateway callback listener negotiation for the compute layer, enabling dynamic coordination between sandboxes and the gateway control plane.
v0.0.97 · Aug 2026
· source
· release history
The SSH handshake secret has been dropped (refactor!(auth): drop SSH handshake secret); any configuration or tooling that supplies or validates this secret will break on upgrade.
v0.0.42 · May 2026
· source
· release history
Adds a gateway-to-sandbox runtime settings channel, enabling live configuration updates to sandboxes without restart.
v0.0.13 · Mar 2026
· source
· release history
+API breaking changes and removalsshippedDocuments removed API fields and commands that require users to update existing configurations or workflows.5 releases · first seen Jul 2026▸
release
External isolation backends: ResumeBoundaryRequest field 3 is renamed from allow_cold_start_fallback to restart_if_restore_fails.
v0.1.6 · Oct 2026
· source
· release history
The Go SDK's SandboxInterface.Create() and CreateFromTemplate() now take functional options (WithLabels(), WithAnnotations(), WithServiceExposures()) instead of a positional labels argument; the CreateOptions struct has been removed. Call sites must be updated.
v0.1.5 · Oct 2026
· source
· release history
External compute drivers that provision openshell-sandbox must update their bootstrap descriptor field from outer_fence to provisioning_evidence.
v0.1.5 · Oct 2026
· source
· release history
The openshell policy prove command and Z3 dependency have been removed; any workflow or script invoking openshell policy prove will break.
v0.0.86 · Jul 2026
· source
· release history
Breaking: removes SandboxTemplate.volume_claim_templates from the API — configurations referencing this field must be updated.
v0.0.74 · Jul 2026
· source
· release history
+Manifest-driven agentshippedLets operators define and drive agent behavior through declarative manifest files rather than imperative commands.3 releases · 1 other source · first seen Jul 2026▸
release
Separates public and contributor agent skill workflows in the skills/ directory.
v0.1.0 · Sep 2026
· source
· release history
Introduces a new manifest-driven gator agent for policy-based workload management.
v0.0.75 · Jul 2026
· source
· release history
Introduces a manifest-driven gator agent, allowing agent behavior to be defined and driven through declarative manifests.
v0.0.75 · Jul 2026
· source
· release history
+Kubernetes agent-sandbox integrationshippedAllows sandboxes to run natively within Kubernetes using the agent-sandbox v1beta1 API.2 releases · 1 other source · first seen Jun 2026▸
Also counts toward: Kubernetes-native deployment
release
Supports Kubernetes agent-sandbox v1beta1 API.
v0.0.72 · Jun 2026
· source
· release history
Adds default_runtime_class_name config option for the Kubernetes driver to set the runtime class on sandbox pods.
v0.0.56 · Jun 2026
· source
· release history
example
Enable the shared Kubernetes supervisor so many sandboxes share one process and failed supervisors are covered by pool replicas.$ [openshell.drivers.kubernetes] supervisor_topology = "gateway" [openshell.gateway] # gateway TLS is required when supervisor_topology = "gateway" # In the Helm values, set replica count: #…
v0.1.6 · Oct 2026
· source
+Network and Traffic Control3 capabilitiesOpenShell controls how traffic flows into and out of sandboxes and through the gateway layer. This includes proxy routing, TLS termination, and layer-7 policy enforcement on sandbox communications.▸
+Sandbox networking and egress controlshippedRoutes sandbox outbound traffic through corporate proxies or custom gateway layers, including signed tunnels for AWS environments.24 releases · first seen Apr 2026▸
release
24 total
Adds supervisor_network_mode setting for the Docker supervisor to enable bridge networking (host networking remains the default).
v0.1.5 · Oct 2026
· source
· release history
Adds feat(docker): support corporate proxy CA bundles — the Docker runtime now accepts corporate proxy CA bundles for TLS inspection environments.
v0.1.3 · Oct 2026
· source
· release history
Supports corporate HTTP forward proxy egress for microVM sandboxes.
v0.1.0 · Sep 2026
· source
· release history
Adds corporate HTTP forward proxy egress support for microVM sandboxes
v0.1.0 · Sep 2026
· source
· release history
Add support for corporate HTTP forward proxy egress for microVM sandboxes.
v0.1.0 · Sep 2026
· source
· release history
Enables Docker and Podman runtimes to enforce policy DNS and transparent TCP, extending L7 network controls to both container backends.
v0.0.111 · Aug 2026
· source
· release history
+L7 policy enforcementshippedEnforces layer-7 policies on JSON-RPC and MCP traffic passing through the tool.9 releases · first seen Mar 2026▸
release
9 total
Adds feat(mcp): inspect requests with Tower-selected protocol profiles — MCP request inspection now uses Tower-selected protocol profiles for policy evaluation.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(mcp): inspect requests with Tower-selected protocol profiles — MCP requests can now be inspected using Tower-selected protocol profiles.
v0.1.3 · Oct 2026
· source
· release history
Preserves exact MCP revision allowlists in policy, enabling pinned MCP version enforcement.
v0.1.0 · Sep 2026
· source
· release history
Adds exact MCP revision allowlists to policy, preserving pinned tool versions
v0.1.0 · Sep 2026
· source
· release history
Adds L7 policy enforcement for JSON-RPC and MCP traffic.
v0.0.72 · Jun 2026
· source
· release history
Adds JSON-RPC and MCP policy enforcement at the L7 layer.
v0.0.72 · Jun 2026
· source
· release history
+Supervisor middleware frameworkshippedsuggestedProvides a middleware layer at the supervisor level for intercepting and controlling sandbox network egress and inspecting content.6 releases · first seen Jul 2026▸
Suggested capability: Model output filtering. This is our guess, not confirmed.
release
Allows operators to enforce middleware binding requirements by setting binding_policy to allowlist or exact.
v0.1.6 · Oct 2026
· source
· release history
Adds binding_policy setting (values: allowlist or exact) to require a middleware service to provide specific bindings such as request inspection.
v0.1.6 · Oct 2026
· source
· release history
Adds supervisor middleware content guard example for filtering or inspecting sandbox traffic at the supervisor layer.
v0.0.96 · Jul 2026
· source
· release history
Introduces a supervisor middleware content guard example, providing a reference implementation for enforcing content policies at the supervisor layer.
v0.0.96 · Jul 2026
· source
· release history
Adds network egress middleware to the supervisor-middleware subsystem
v0.0.86 · Jul 2026
· source
· release history
+Security Policy and Access Control5 capabilitiesOpenShell applies and enforces security controls across sandbox identity, image resolution, runtime permissions, and credential handling. This area governs what sandboxes can do and what they are allowed to access.▸
+Workspace managementshippedManages workspaces as scoped, authorization-enforced resources to support structured multi-tenant access control.7 releases · 1 other source · first seen May 2026▸
Also counts toward: Multi-tenant management
release
7 total
The gateway now rejects annotation keys with the reserved internal.openshell.ai/ prefix on CreateSandbox and UpdateConfig.
v0.1.5 · Oct 2026
· source
· release history
Wires authorization checks into the workspace model, enabling access control enforcement at the workspace level.
v0.0.96 · Jul 2026
· source
· release history
Wires authorization into the workspace model, extending access control enforcement to workspace operations.
v0.0.96 · Jul 2026
· source
· release history
Adds a workspace resource model with scoping and membership support, enabling structured multi-tenant workspace management.
v0.0.88 · Jul 2026
· source
· release history
feat(workspace) introduces the workspace resource model for scoping and membership management.
v0.0.88 · Jul 2026
· source
· release history
Gateway persistence now uses a shared entity schema with Kubernetes-style metadata and labels, replacing the previous schema; existing gateway state is not forward-compatible.
v0.0.37 · May 2026
· source
· release history
example
Create a new named sandbox$ openshell sandbox create --name demo
+Credential exposure warningshippedsuggestedWarns users at the CLI when environment variable values appear to contain credentials before they are passed into a sandbox.4 releases · 2 other sources · first seen Aug 2026▸
Suggested capability: Data loss prevention. This is our guess, not confirmed.
Also counts toward: Command-line interface
release
Adds --env-from KEY[=ENVVAR] flag to openshell sandbox create to pass sandbox environment variables from the caller's environment without putting values on the command line.
v0.1.5 · Oct 2026
· source
· release history
Adds a warning when values passed to --env look like credentials, helping prevent accidental secret exposure at sandbox creation.
v0.0.104 · Aug 2026
· source
· release history
Adds a warning when --env values passed to the CLI look like credentials, helping catch accidental secret exposure at the command line.
v0.0.104 · Aug 2026
· source
· release history
Adds a warning when --env values appear to contain credentials
v0.0.104 · Aug 2026
· source
· release history
example
Pass secrets from the local environment into a new sandbox without exposing them in shell history or process listings.$ openshell sandbox create --name agent-run --env-from AWS_ACCESS_KEY_ID --env-from AWS_SECRET_ACCESS_KEY --annotation team=security -- python agent.py
v0.1.5 · Oct 2026
· source
Catch accidental credential exposure before a sandbox starts — the CLI warns when an --env value resembles a secret.$ openshell sandbox create --env API_KEY=sk-abc123secret -- claude
v0.0.104 · Aug 2026
· source
+OCI image identity and policy resolutionshippedUses security policies as the primary authority for resolving the identity of OCI images running inside sandboxes.4 releases · first seen May 2026▸
release
Introduces policy-first OCI image identity resolution in the sandbox, giving security policies priority in image evaluation.
v0.0.96 · Jul 2026
· source
· release history
Adopts policy-first OCI image identity for sandboxes, making policy the authoritative source for image identification.
v0.0.96 · Jul 2026
· source
· release history
Adds system registry support and source indicators to the gateway.
v0.0.62 · Jun 2026
· source
· release history
Injects DENO_CERT into the sandbox child environment, enabling custom CA trust for Deno-based sandboxes.
v0.0.44 · May 2026
· source
· release history
+System CA trust configurationshippedConfigures sandboxes to trust the host system's certificate authorities so they can verify TLS connections to internal services.3 releases · first seen Apr 2026▸
release
Adds system CA root mode, allowing sandboxes to trust the host's CA certificate bundle for TLS verification.
v0.0.99 · Aug 2026
· source
· release history
Adds system CA root mode to the build, enabling sandboxes to trust the host's system certificate authorities.
v0.0.99 · Aug 2026
· source
· release history
Loads system CA certificates for upstream TLS connections in sandbox environments, enabling trust of enterprise/internal CAs without manual config.
v0.0.32 · Apr 2026
· source
· release history
+Privileged gateway session visibilityshippedExposes additional context about elevated or privileged sessions within the gateway component.1 release · first seen Jul 2026▸
release
Adds elevated gateway info to the gateway component, surfacing additional context for privileged gateway sessions.
v0.0.85 · Jul 2026
· source
· release history
+Cloud Credential and Provider Integration1 capabilityOpenShell integrates with cloud provider credential systems to authenticate sandbox and gateway operations against cloud backends. It supports dynamic credential refresh and static credential binding to specific routes.▸
+Cloud provider credential managementshippedIntegrates with AWS STS for credential refresh and supports binding static credentials to specific provider proxy endpoints for injection into backend requests.15 releases · 1 other source · first seen Mar 2026▸
release
15 total
Adds operator-only provider credential retrieval so gateway operators can fetch provider credentials without exposing them to sandbox workloads.
v0.1.4 · Oct 2026
· source
· release history
Adds operator-only provider credential retrieval so privileged identities can fetch provider credentials without exposing them to sandbox workloads.
v0.1.4 · Oct 2026
· source
· release history
Adds support for stable credential placeholders in providers, letting policies reference credentials by stable name across rotations.
v0.1.4 · Oct 2026
· source
· release history
Adds CLI label creation and filtering for providers, enabling operators to tag and query providers by label.
v0.1.4 · Oct 2026
· source
· release history
Stores refresh credentials in credential drivers so providers can maintain long-lived credential sessions without re-authentication.
v0.0.110 · Aug 2026
· source
· release history
Stores refresh credentials in credential drivers so providers can renew tokens without user intervention.
v0.0.110 · Aug 2026
· source
· release history
example
Pass AWS credentials as a Kubernetes Secret reference to the gateway container via Helm without hardcoding values in values.yaml.$ helm upgrade --install openshell deploy/helm/openshell \ --namespace openshell \ --set 'server.extraEnv[0].name=AWS_ACCESS_KEY_ID' \ --set 'server.extraEnv[0].valueFrom.secretKeyRef.name=aws-creds' \…
v0.1.6 · Oct 2026
· source
+Observability, CLI, and Developer Tooling3 capabilitiesOpenShell provides tooling for operators and developers to monitor, script, and build against the platform. This covers tracing exports, machine-readable CLI output, and the interactive terminal interface.▸
+Distributed tracing and observabilityshippedExports traces from the gateway and VM-backed sandbox drivers over OTLP so sandbox and gateway activity can be observed in distributed tracing systems.27 releases · 1 other source · first seen Mar 2026▸
release
27 total
Use OTLP/HTTP instead of gRPC for telemetry export by setting protocol = "http/protobuf" on [openshell.gateway.otlp] or any signal sub-table; gRPC remains the default.
v0.1.7 · Nov 2026
· source
· release history
Forward sandboxed agent OpenTelemetry traces to your collector without an egress rule by adding [openshell.gateway.otlp.agent] with enabled = true to gateway.toml; the supervisor tags each span with the sandbox id before forwarding.
v0.1.7 · Nov 2026
· source
· release history
Authenticate or route OTLP traffic by setting headers or headers_file on [openshell.gateway.otlp] or a signal table, so collectors like MLflow can receive relayed agent traces via x-mlflow-experiment-id.
v0.1.7 · Nov 2026
· source
· release history
Adds [openshell.gateway.otlp.ocsf] config block with enabled = true to export OCSF events as OTLP log records, and allows traces and OCSF events to be sent to separate OTLP endpoints.
v0.1.5 · Oct 2026
· source
· release history
Adds feat(supervisor): export OTLP traces from sandbox supervisors — sandbox supervisors now emit OpenTelemetry traces over OTLP for observability pipelines.
v0.1.3 · Oct 2026
· source
· release history
Enables exporting driver traces over the OTLP protocol via feat(kubernetes)
v0.0.115 · Aug 2026
· source
· release history
example
Send agent traces from inside a sandbox to your OTLP collector, authenticated with an MLflow experiment header, without writing an egress rule.$ [openshell.gateway.otlp.agent] enabled = true [openshell.gateway.otlp] protocol = "http/protobuf" headers_file = "/etc/openshell/otlp-headers.txt"
v0.1.7 · Nov 2026
· source
+Machine-readable CLI outputverifiedOutputs sandbox status and results in JSON or YAML from CLI commands so they can be consumed in scripts, CI pipelines, and audit logs.13 releases · 10 other sources · first seen May 2026▸
Also counts toward: CI/CD pipeline integration, Command-line interface, JSON data export
release
13 total
Adds --annotation KEY=VALUE repeatable flag to openshell sandbox create for setting sandbox annotations from the CLI.
v0.1.5 · Oct 2026
· source
· release history
Adds gRPC server reflection (v1 protocol) to the gateway, enabling grpcurl -plaintext localhost:18080 list and schema introspection without supplying proto files.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
v0.1.4 · Oct 2026
· source
· release history
Adds gRPC server reflection to the gateway, enabling grpcurl -plaintext localhost:18080 list and describe without supplying proto files.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
v0.1.4 · Oct 2026
· source
· release history
Adds structured output to list commands for machine-readable CLI results
v0.1.0 · Sep 2026
· source
· release history
Adds structured output to openshell list commands for machine-readable results.
v0.1.0 · Sep 2026
· source
· release history
Enable structured (JSON) output for list commands via new formatting options.
v0.1.0 · Sep 2026
· source
· release history
docs
This page is for version Latest (v0.1.6) (default). - Latest (v0.1.6) (default): https://docs.nvidia.com/openshell/latest/llms.txt - v0.1.6: https://docs.nvidia.com/openshell/v0.1.6/llms.txt
seen Oct 2026
· source
Introspect the gateway's gRPC API surface on a local plaintext gateway without any proto files checked out.$ grpcurl -plaintext localhost:18080 list grpcurl -plaintext localhost:18080 describe openshell.v1.OpenShell grpcurl -plaintext -d '{}' localhost:18080 openshell.v1.OpenShell/Health
v0.1.4 · Oct 2026
· source
Explore the gateway's gRPC API interactively — list services, inspect the schema, or call Health — without a local copy of the proto files.$ grpcurl -plaintext localhost:18080 list grpcurl -plaintext localhost:18080 describe openshell.v1.OpenShell grpcurl -plaintext -d '{}' localhost:18080 openshell.v1.OpenShell/Health
v0.1.4 · Oct 2026
· source
Pipe sandbox status into jq or other tooling by requesting JSON output — useful in CI pipelines or scripted workflows.$ openShell sandbox status --output json | jq '.state'
v0.0.92 · Jul 2026
· source
Get sandbox status in JSON format for programmatic parsing$ openshell sandbox status --output json
v0.0.92 · Jul 2026
· source
Parse sandbox creation output in CI pipelines or scripts that need the sandbox ID or status without scraping human-readable text.$ openshell sandbox create --output json -- claude
v0.0.92 · Jul 2026
· source
Create a new sandbox with YAML output for easy review of created resources$ openshell sandbox create --name my-sandbox --output yaml
v0.0.92 · Jul 2026
· source
+Terminal UI (TUI)shippedProvides an interactive terminal UI with keyboard navigation for managing providers and sandbox configurations without writing config files directly.7 releases · first seen Apr 2026▸
Also counts toward: OIDC SSO
release
7 total
feat(tui): add config key support to provider create/update forms
v0.0.90 · Jul 2026
· source
· release history
Adds config key support to provider create and update forms in the terminal UI.
v0.0.90 · Jul 2026
· source
· release history
Enables Up/Down arrow key navigation across panels with overflow at list boundaries in the TUI.
v0.0.86 · Jul 2026
· source
· release history
Adds PageUp/PageDown scrolling to all panes in the terminal UI.
v0.0.53 · Jun 2026
· source
· release history
Adds OIDC authentication support to the TUI, allowing users to authenticate via identity providers from the terminal interface.
v0.0.43 · May 2026
· source
· release history
Adds bidirectional streaming for interactive TTY sessions in exec, enabling real interactive shell workflows.
v0.0.43 · May 2026
· source
· release history
+Build and Platform Support3 capabilitiesOpenShell supports multiple build systems and target platforms so it can be compiled and deployed in varied infrastructure environments. This includes Windows support, Bazel targets, and static binary options.▸
+Bazel build system supportshippedProvides Bazel build targets for tool components as an alternative to the default build path.10 releases · 1 other source · first seen May 2026▸
release
10 total
Adds Bazel build targets for the credential driver, enabling it to be compiled as part of the standard build.
v0.0.101 · Aug 2026
· source
· release history
build(bazel) now includes credential_driver targets to streamline building credential drivers via Bazel.
v0.0.101 · Aug 2026
· source
· release history
Adds Bazel build targets for credential drivers, enabling the credential driver components to be built as part of the standard Bazel build graph.
v0.0.101 · Aug 2026
· source
· release history
Introduces a prototype Bazel build system, including OpenTelemetry crate targets, for an alternative build path.
v0.0.97 · Aug 2026
· source
· release history
Prototypes a Bazel build system for the project, laying groundwork for reproducible, hermetic builds.
v0.0.97 · Aug 2026
· source
· release history
feat(build): prototype Bazel build system as an alternative to the existing build process
v0.0.97 · Aug 2026
· source
· release history
example
Build credential drivers for your cyber toolchain using the new Bazel targets.$ bazel build //credential_driver:all
v0.0.101 · Aug 2026
· source
+Windows platform supportshippedCompiles the gateway and CLI components on Windows, extending the platforms where OpenShell can be operated.3 releases · first seen Aug 2026▸
release
Enables Windows native compilation support for the gateway and CLI.
v0.0.104 · Aug 2026
· source
· release history
Adds windows compilation support for the gateway and cli components
v0.0.104 · Aug 2026
· source
· release history
Adds Windows compilation support for the gateway and CLI components.
v0.0.104 · Aug 2026
· source
· release history
+Static linking supportshippedOffers a statically linked supervisor binary variant for environments that cannot rely on dynamic glibc linking.2 releases · first seen Aug 2026▸
release
Adds a glibc-static supervisor libc variant for environments where dynamic glibc linking is unavailable.
v0.0.104 · Aug 2026
· source
· release history
Adds a glibc-static supervisor libc variant for environments that require static linking.
v0.0.104 · Aug 2026
· source
· release history
+Other2 capabilitiesCapabilities that did not group under any area above.▸
+Container runtime security controlsshippedApplies SELinux labels to bind mounts in Docker and Podman runtimes, and supports numeric UIDs when specifying sandbox process identity in policies.7 releases · first seen May 2026▸
Shared capability: Container runtime protection
release
7 total
feat(policy): allow non-root sandbox identities
v0.0.110 · Aug 2026
· source
· release history
Allows non-root identities inside sandbox environments, expanding the range of workloads and privilege models that sandboxes can run.
v0.0.110 · Aug 2026
· source
· release history
Allows non-root identities inside sandbox environments, expanding the range of workloads and privilege models that sandboxes can support.
v0.0.110 · Aug 2026
· source
· release history
Adds SELinux label support for bind mounts in Docker and Podman container runtimes.
v0.0.76 · Jul 2026
· source
· release history
Supports SELinux labels on bind mounts for Docker and Podman container runtimes.
v0.0.76 · Jul 2026
· source
· release history
Enables numeric UIDs (in addition to named users) when specifying sandbox process identity in policies.
v0.0.76 · Jul 2026
· source
· release history
+Ingress TLS terminationshippedTerminates TLS for Envoy Gateway ingress via Helm, enabling encrypted traffic handling at the ingress layer.2 releases · first seen Jul 2026▸
release
Adds TLS termination support for Envoy Gateway ingress via Helm configuration.
v0.0.75 · Jul 2026
· source
· release history
Adds TLS termination support for Envoy Gateway ingress via Helm, enabling encrypted traffic handling at the ingress layer.
v0.0.75 · Jul 2026
· source
· release history
+Other28 capabilities▸
+Infrastructure and deployment configurationshippedManages infrastructure components including TLS certificate generation, VM driver installation, service routing, and microVM gateways.28 releases · 3 other sources · first seen Apr 2026▸
release
28 total
Give each sandbox service a unique hostname when multiple gateways share a cluster by setting service_hostname_format = "hashed" under [openshell.gateway]; the previous readable default is unchanged.
v0.1.7 · Nov 2026
· source
· release history
Opt into a new supervisor TLS listener that lets declared HTTP and WebSocket sandbox services accept application traffic directly, bypassing the gateway; disabled by default.
v0.1.7 · Nov 2026
· source
· release history
Adds server.extraEnv to the Helm chart for passing extra environment variables (including Secret references) to the gateway container.
v0.1.6 · Oct 2026
· source
· release history
Adds server.extraEnv to the Helm chart for passing extra environment variables, including Secret references, to the gateway container, and adds pkiInitJob.podLabels and pkiInitJob.podAnnotations to the Helm chart for the certificate hook pods.
v0.1.6 · Oct 2026
· source
· release history
Adds pkiInitJob.podLabels and pkiInitJob.podAnnotations to the Helm chart for certificate hook pods.
v0.1.6 · Oct 2026
· source
· release history
Runs the snap gateway as a user service by default instead of a system service.
v0.1.4 · Oct 2026
· source
· release history
example
Build the VM driver and fetch the runtime from Github via Bazel.$ bazel build //vm_driver:vm_driver_runtime
v0.0.101 · Aug 2026
· source
Generate gateway TLS certificates during RPM-based deployment instead of running the old init-pki.sh script.$ openshell-gateway generate-certs
v0.0.44 · May 2026
· source
Install the OpenShell gateway and VM driver with a custom driver directory during VM setup.$ OPENSHELL_VERSION=v0.0.34 sh install.sh install-vm --driver-dir <path>
v0.0.34 · Apr 2026
· source
+Compute driver abstraction and injectionshippedSupports pluggable compute drivers for various runtimes including Docker, Podman, Kubernetes, and MicroVMs, with specific support for GPU device injection via CDI.13 releases · 3 other sources · first seen Mar 2026▸
Also counts toward: Command-line interface, Plugin API support, Plugin system
release
13 total
Advertises resource capabilities from compute drivers to the gateway
v0.1.0 · Sep 2026
· source
· release history
Expose resource capabilities advertising from the compute layer.
v0.1.0 · Sep 2026
· source
· release history
Advertises compute resource capabilities from drivers, making sandbox resource metadata visible to the control plane.
v0.1.0 · Sep 2026
· source
· release history
Adds a canonical main process to the sandbox runtime.
v0.0.111 · Aug 2026
· source
· release history
Sandboxes now honor the working directory declared in OCI container images, so containers start in the path their image specifies.
v0.0.99 · Aug 2026
· source
· release history
Supports out-of-tree compute drivers on the server via the new --compute-driver-socket flag.
v0.0.71 · Jun 2026
· source
· release history
example
Load a custom or out-of-tree compute driver without rebuilding the server — useful when running non-standard GPU drivers in air-gapped or specialized environments.$ openshell-server --compute-driver-socket /path/to/custom-driver.sock
v0.0.71 · Jun 2026
· source
Execute GPU-specific tasks within an OpenShell cluster environment.$ openshell run cluster:gpu
v0.0.16 · Mar 2026
· source
Run end-to-end tests that leverage the new GPU task infrastructure.$ openshell run e2e:gpu
v0.0.16 · Mar 2026
· source
+Programmatic SDKs (Go and TypeScript)shippedProvides official SDKs for programmatic integration, authentication, and domain client operations.14 releases · first seen Jun 2026▸
Also counts toward: Client SDKs
release
14 total
The Rust, Go, Python, and TypeScript SDKs now send exec calls directly to the gateway replica that owns the sandbox when replica routing is enabled; Go also routes port-forward and SSH tunnel calls, and TypeScript routes port-forward.
v0.1.7 · Nov 2026
· source
· release history
Stable releases now tag the Go SDK module as sdk/go/vX.Y.Z so Go tooling and pkg.go.dev show real versions.
v0.1.6 · Oct 2026
· source
· release history
Adds watchLogs with loss-aware resume to the TypeScript SDK for streaming sandbox logs that automatically reconnects and tracks gaps.
v0.1.4 · Oct 2026
· source
· release history
Adds watchLogs with loss-aware resume to the TypeScript SDK, allowing log streaming to recover from gaps without restarting from the beginning.
v0.1.4 · Oct 2026
· source
· release history
Adds createdAtMs field to SandboxRef in the TypeScript SDK for millisecond-precision sandbox creation timestamps.
v0.1.4 · Oct 2026
· source
· release history
Adds createdAtMs field to SandboxRef in the TypeScript SDK, exposing sandbox creation time in milliseconds.
v0.1.4 · Oct 2026
· source
· release history
+Security posture and transport configurationshippedConfigures security aspects including service account auto-mounting, HTTPS/mTLS separation, and system CA trust injection.12 releases · 1 other source · first seen May 2026▸
release
12 total
Connect OTLP collectors over mutual TLS or private CAs by setting ca_file, and optionally cert_file and key_file, on [openshell.gateway.otlp] or a signal table.
v0.1.7 · Nov 2026
· source
· release history
Route sandbox egress through a private PKI by setting [openshell.supervisor.network].additional_ca_bundle to a PEM bundle, applying to every first-party compute driver.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
v0.1.7 · Nov 2026
· source
· release history
Adds feat(docker): support corporate proxy CA bundles — the Docker runtime now accepts corporate proxy CA bundles for TLS inspection environments.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(docker): support corporate proxy CA bundles — Docker-based deployments can now supply corporate proxy CA certificates for outbound TLS validation.
v0.1.3 · Oct 2026
· source
· release history
Trusts corporate CA certificates for HTTPS proxies and intercepted TLS within Podman-backed sandboxes.
v0.0.113 · Aug 2026
· source
· release history
Trusts corporate CA certificates for HTTPS proxies and intercepted TLS traffic in Podman-backed sandboxes.
v0.0.113 · Aug 2026
· source
· release history
example
Connect your OTLP collector over mutual TLS using a private CA, so traces are encrypted end-to-end without a public certificate.$ [openshell.gateway.otlp] ca_file = "/etc/openshell/pki/ca.pem" cert_file = "/etc/openshell/pki/client.pem" key_file = "/etc/openshell/pki/client-key.pem"
v0.1.7 · Nov 2026
· source
+OCSF AI inference event emissionshippedEmits structured audit events for AI operations using the OCSF standard.12 releases · first seen Aug 2026▸
Shared capability: LLM application tracing
release
12 total
OpenShell now emits only OCSF 1.8.0 records; deployments that relied on 1.1 or 1.3 records will now receive 1.8.0 records.
v0.1.7 · Nov 2026
· source
· release history
Gateways now emit OCSF audit events for authorization denials, accepted credentials, SSH session tokens, and sandbox token checks, and raise a High-severity finding on suspected sandbox credential misuse.
v0.1.6 · Oct 2026
· source
· release history
Gateways now write OCSF audit events for authorization denials, accepted credentials, SSH session tokens, and sandbox token checks, and raise a High-severity finding when a sandbox credential looks misused.
v0.1.6 · Oct 2026
· source
· release history
Adds feat(server): write gateway OCSF events to JSONL — the gateway now emits structured audit events in OCSF JSONL format.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(server): write gateway OCSF events to JSONL — the gateway now emits audit events in OCSF format to a JSONL file, and feat(helm): configure gateway OCSF JSONL output exposes Helm values to configure this output.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(helm): configure gateway OCSF JSONL output — Helm values expose controls for enabling and routing the gateway's OCSF JSONL audit stream.
v0.1.3 · Oct 2026
· source
· release history
+Gateway persistence and lifecycle managementshippedManages gateway state persistence using Kubernetes-style metadata, supports session resumption across restarts, and enables direct binary deployment.10 releases · 2 other sources · first seen Apr 2026▸
release
10 total
Adds feat(sandbox): add main restart policy — sandboxes support a main-process restart policy to recover from agent crashes.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(sandbox): add main restart policy — configure a restart policy for the primary sandbox process.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
v0.1.3 · Oct 2026
· source
· release history
Adds start and stop operations to manage sandbox lifecycle
v0.0.105 · Aug 2026
· source
· release history
Adds VM lifecycle extensions for managing virtual machine states.
v0.0.59 · Jun 2026
· source
· release history
Adds resource version compare-and-swap (CAS) support to the database layer.
v0.0.44 · May 2026
· source
· release history
Public protobuf shapes for core resources (sandboxes, providers, SSH sessions) have changed; existing clients and gateway instances must be recreated.
v0.0.37 · May 2026
· source
· release history
example
Suspend a running sandbox to free resources, then restart it later without losing the environment.$ openshell sandbox stop my-sandbox # ... later ... openshell sandbox start my-sandbox
v0.0.105 · Aug 2026
· source
Before upgrading from v0.0.36, clean up incompatible gateway state to avoid data loss.$ openshell sandbox delete --all && openshell gateway destroy
v0.0.37 · May 2026
· source
+Third-party AI inference providersshippedIntegrates natively supported external LLM backends and agent providers for sandbox inference.12 releases · first seen Mar 2026▸
release
12 total
Adds feat(providers): add Oracle Cloud Infrastructure Generative AI provider profile — a new OCI Generative AI provider profile is available for credential-scoped inference routing.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
v0.1.3 · Oct 2026
· source
· release history
Adds feat(providers): add multiple tokens to one request — a single outbound request can now carry tokens from multiple providers simultaneously.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(providers): add Oracle Cloud Infrastructure Generative AI provider profile — OCI Generative AI is now a first-class provider profile.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(providers): add multiple tokens to one request — a single provider request can now carry multiple tokens.
v0.1.3 · Oct 2026
· source
· release history
Adds AWS Bedrock as a recognized inference provider in sandbox and provider configurations.
v0.0.69 · Jun 2026
· source
· release history
Adds DeepInfra as a built-in inference provider, expanding the set of natively supported LLM backends.
v0.0.65 · Jun 2026
· source
· release history
+Gateway RBAC and OIDC authenticationshippedManages gateway access control through OIDC/Keycloak integration with scope-based permissions.10 releases · first seen May 2026▸
Also counts toward: Role-based access control
release
10 total
Gateways now refuse to start unless OIDC, mTLS user or operator authentication, or gateway JWTs are configured; for trusted local development only, set allow_unauthenticated_users = true under [openshell.gateway.auth].
v0.1.6 · Oct 2026
· source
· release history
Delegates sandbox authentication to compute drivers, enabling driver-owned auth flows
v0.1.0 · Sep 2026
· source
· release history
Supports EC and EdDSA keys in OIDC JWKS validation on the server.
v0.1.0 · Sep 2026
· source
· release history
Delegate sandbox authentication to drivers for compute providers.
v0.1.0 · Sep 2026
· source
· release history
Adds EC and EdDSA key support in OIDC JWKS validation on the server
v0.1.0 · Sep 2026
· source
· release history
Delegates sandbox authentication to compute drivers, enabling driver-owned auth flows.
v0.1.0 · Sep 2026
· source
· release history
+Interactive session executionshippedProvides capabilities to execute commands with TTY support and real-time bidirectional streaming within sandboxed environments.4 releases · 5 other sources · first seen Apr 2026▸
Also counts toward: Command-line interface
release
Adds feat(cli): detach sandbox sessions with Ctrl-D — pressing Ctrl-D inside a sandbox session now detaches cleanly rather than terminating.
v0.1.3 · Oct 2026
· source
· release history
Supports multiple --upload flags on sandbox create, enabling several files to be uploaded in a single command.
v0.0.56 · Jun 2026
· source
· release history
Adds TTY support for exec in the VM driver.
v0.0.37 · May 2026
· source
· release history
Detach from a running sandbox session without terminating it — useful in CI or long-running agent workflows where you want to leave the sandbox alive.$ openshell sandbox connect my-sandbox # Inside the session, press Ctrl-D to detach cleanly
v0.1.3 · Oct 2026
· source
Drop into a sandbox for debugging without sourcing .bashrc or .profile, so startup-file side-effects don't interfere with your session.$ openshell sandbox exec my-sandbox --no-login-shell
v0.1.0 · Sep 2026
· source
Enter a sandbox without running startup files — useful for clean, reproducible script execution that should not be affected by a user's shell profile$ openshell sandbox exec my-sandbox --no-login-shell -- bash -c 'python main.py'
v0.1.0 · Sep 2026
· source
Pass environment variables into a one-off exec inside a running sandbox, e.g. to parameterize a training run.$ openshell sandbox exec --env BATCH_SIZE=64 --env DEBUG=1 <sandbox-name> -- python train.py
v0.0.59 · Jun 2026
· source
Inject environment variables into a sandbox at creation time — useful for passing secrets or runtime config without baking them into the image.$ openshell sandbox create --env MY_API_KEY=abc123 --env ENV=production <sandbox-name>
v0.0.59 · Jun 2026
· source
+Authoritative provider profilesshippedEnforces gateway policy via imported provider profiles rather than advisory settings.7 releases · first seen Apr 2026▸
release
7 total
Make provider profiles authoritative in the policy layer.
v0.1.0 · Sep 2026
· source
· release history
Makes provider profiles authoritative, with the gateway serving exactly the profiles imported via openshell provider profile import
v0.1.0 · Sep 2026
· source
· release history
Makes provider profiles authoritative, so profile definitions drive sandbox authentication rather than being advisory.
v0.1.0 · Sep 2026
· source
· release history
Introduces profile-backed policy visibility, enabling policy inspection tied to user profiles.
v0.0.55 · Jun 2026
· source
· release history
Enables automatic provider discovery derived from profiles, reducing manual provider configuration.
v0.0.48 · May 2026
· source
· release history
+Middleware response mutationshippedIntercepts and mutates HTTP responses via middleware before returning them.6 releases · first seen Sep 2026▸
release
Adds feat(service): add bearer authorization passthrough — the gateway can forward bearer tokens directly to upstream endpoints without credential substitution.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(service): add bearer authorization passthrough — the gateway service layer can forward bearer tokens from inbound requests to upstream endpoints.
v0.1.3 · Oct 2026
· source
· release history
Defines an HTTP response pre-return interface in middleware for new extension hooks.
v0.1.0 · Sep 2026
· source
· release history
Broadens HTTP header mutation authority in middleware
v0.1.0 · Sep 2026
· source
· release history
Broadens HTTP header mutation authority in middleware, expanding the extension surface for interceptors.
v0.1.0 · Sep 2026
· source
· release history
Adds HTTP response pre-return interface in middleware for intercepting and mutating responses before they are returned
v0.1.0 · Sep 2026
· source
· release history
+Sandbox template managementverifiedEnables server-side sandbox templates for reusable configuration definitions.5 releases · 1 other source · first seen Sep 2026▸
Also counts toward: Command-line interface
release
Adds feat(providers): serve sandbox config files on demand — providers can now serve sandbox configuration files on demand rather than bundling them at creation time.
v0.1.3 · Oct 2026
· source
· release history
Adds feat(providers): serve sandbox config files on demand — providers can now deliver configuration files into the sandbox at runtime on request.
v0.1.3 · Oct 2026
· source
· release history
Adds sandbox templates on the server, allowing pre-defined sandbox configurations to be reused
v0.1.0 · Sep 2026
· source
· release history
Introduce sandbox templates feature to define reusable sandbox configurations.
v0.1.0 · Sep 2026
· source
· release history
Adds sandbox templates on the server, allowing reusable sandbox configuration to be defined once and referenced at creation time.
v0.1.0 · Sep 2026
· source
· release history
command line
--template — Create from a named sandbox workload template. Conflicts with inline workload flags such as `--from`, `--gpu`, `--cpu`, `--memory`, `--env`, and `--driver-config-json`.
v0.1.0-pre.2 · Sep 2026
· command-line history
+First-party compute driver supportshippedAllows the gateway to use built-in standalone compute drivers without external dependencies.6 releases · first seen Apr 2026▸
release
Adds native Windows MXC compute driver with full server wiring, expanding supported compute platforms to include Windows-native MXC environments.
v0.0.115 · Aug 2026
· source
· release history
Adds native Windows MXC compute driver support with server wiring via feat(driver-mxc)
v0.0.115 · Aug 2026
· source
· release history
Adds a native Windows MXC compute driver with full server wiring, extending supported compute platforms to Windows MXC.
v0.0.115 · Aug 2026
· source
· release history
Adds standalone first-party compute drivers for sandbox execution.
v0.0.111 · Aug 2026
· source
· release history
Adds standalone first-party compute drivers, allowing the gateway to use built-in drivers without external dependencies.
v0.0.111 · Aug 2026
· source
· release history
Adds a standalone libkrun compute driver for VM-based workload isolation.
v0.0.33 · Apr 2026
· source
· release history
+Sandbox suspend and resumeshippedAllows users to pause a running sandbox to free compute resources and resume it later without losing state, on supported compute drivers.3 releases · 2 other sources · first seen Oct 2026▸
Also counts toward: Command-line interface
release
Adds openshell sandbox suspend and openshell sandbox resume commands to pause and restore sandboxes on supported compute drivers.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
v0.1.6 · Oct 2026
· source
· release history
External isolation backends using ResumeBoundaryRequest: field 3 is renamed from allow_cold_start_fallback to restart_if_restore_fails.
v0.1.6 · Oct 2026
· source
· release history
Adds openshell sandbox suspend and openshell sandbox resume commands to pause and resume sandboxes on supported compute drivers.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
v0.1.6 · Oct 2026
· source
· release history
example
Pause a long-running agent sandbox mid-task and restore it later, preserving in-memory state.$ openshell sandbox suspend my-agent-sandbox # ... later ... openshell sandbox resume my-agent-sandbox
v0.1.6 · Oct 2026
· source
Pause a long-running sandbox to free compute resources, then resume it later without losing state.$ openshell sandbox suspend my-sandbox # ... later ... openshell sandbox resume my-sandbox
v0.1.6 · Oct 2026
· source
+Telemetry-free build optionshippedProvides a feature alias for building the tool without telemetry components.3 releases · 2 other sources · first seen Jun 2026▸
release
Adds defaults-without-telemetry feature alias for builds that omit telemetry
v0.1.0 · Sep 2026
· source
· release history
Adds a defaults-without-telemetry feature alias at build time, enabling telemetry-free builds without manual feature flag composition.
v0.1.0 · Sep 2026
· source
· release history
Adds anonymous usage telemetry with an opt-out mechanism for OpenShell deployments.
v0.0.54 · Jun 2026
· source
· release history
example
Disable telemetry on a Helm-deployed gateway so no operational data leaves your cluster.$ helm upgrade --install openshell deploy/helm/openshell \ --namespace openshell \ --set server.telemetryEnabled=false
v0.1.3 · Oct 2026
· source
Disable anonymous telemetry collection on a self-hosted gateway without recompiling — set this in your gateway environment before start-up.$ OPENSHELL_TELEMETRY_ENABLED=false openshell sandbox create --name demo
v0.1.3 · Oct 2026
· source
+Supply-chain provenance publishingshippedPublishes OCI SBOM and provenance attestations alongside release artifacts.5 releases · first seen Aug 2026▸
release
Adds Codex Security release qualification to the CI pipeline.
v0.1.0 · Sep 2026
· source
· release history
Adds Codex Security release qualification to the CI pipeline
v0.1.0 · Sep 2026
· source
· release history
Publishes OCI SBOM and provenance attestations alongside release artifacts, supporting supply-chain verification workflows.
v0.0.115 · Aug 2026
· source
· release history
Publishes OCI SBOM and provenance attestations alongside release artifacts for supply-chain verification.
v0.0.115 · Aug 2026
· source
· release history
Publishes OCI SBOM and provenance attestations in the release artifacts via feat(build)
v0.0.115 · Aug 2026
· source
· release history
+VM driver sandbox provisioningshippedSupports provisioning sandbox environments from pre-built rootfs tar archives.2 releases · 2 other sources · first seen Sep 2026▸
Also counts toward: Command-line interface
release
Support VM driver with --from rootfs source using tar archives.
v0.1.0 · Sep 2026
· source
· release history
Adds --from flag accepting a rootfs tar archive as the source for VM driver sandboxes.
v0.1.0 · Sep 2026
· source
· release history
example
Create a VM-backed sandbox from a rootfs tar archive instead of a container image$ openshell sandbox create --from rootfs.tar -- bash
v0.1.0 · Sep 2026
· source
Provision a VM-driver sandbox from a pre-built rootfs tar archive instead of a container image — useful when your artifact pipeline produces filesystem tarballs.$ openshell sandbox create --name rootfs-sandbox --from ./rootfs.tar
v0.1.0 · Sep 2026
· source
+Sandbox run metadata and source context flagsverifiedAllows users to attach non-secret metadata annotations and specify a branch when running sandboxes via the CLI.3 other sources · first seen Oct 2026▸
+Headless CLI authenticationshippedRuns authentication flows in non-interactive or headless environments without requiring a web browser.2 releases · 1 other source · first seen Mar 2026▸
Also counts toward: Command-line interface
release
feat(cli): support OIDC device authorization grant for headless login
v0.0.110 · Aug 2026
· source
· release history
Add OPENSHELL_NO_BROWSER environment variable to suppress browser popup during auth
v0.0.11 · Mar 2026
· source
· release history
example
Run CLI authentication in headless or non-interactive environments without opening a web browser.$ OPENSHELL_NO_BROWSER=1 openshell auth
v0.0.11 · Mar 2026
· source
+Shared Kubernetes supervisorshippedRuns a single supervisor process that hosts multiple sandboxes with configurable replica count for failover capacity in Kubernetes environments.1 release · 1 other source · first seen Oct 2026▸
release
config preflight and gateway startup now reject an [openshell.gateway.supervisor_pool] table when the selected driver does not use shared supervision, and also reject a pool recovery timeout shorter than member failure detection.
v0.1.7 · Nov 2026
· source
· release history
example
Enable the experimental shared Kubernetes supervisor to host many sandboxes in one process and configure two replicas for failover capacity.$ [openshell.drivers.kubernetes] supervisor_topology = "gateway" [supervisor] replicas = 2
v0.1.6 · Oct 2026
· source
+Prerelease channel distributionshippedPublishes prerelease builds to the snap beta channel so users can install and test upcoming features before a stable release.1 release · 1 other source · first seen Oct 2026▸
release
Prerelease builds now publish to the snap's latest/beta channel; OPENSHELL_VERSION=pre install.sh installs from there.
v0.1.6 · Oct 2026
· source
· release history
example
Install the latest prerelease build via the snap beta channel to test upcoming features before a stable release.$ OPENSHELL_VERSION=pre curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
v0.1.6 · Oct 2026
· source
+Reverse control connection architectureshippedOpens the sandbox control connection from sandbox to supervisor rather than the reverse, requiring coordinated upgrades of supervisor and sandbox runtime binaries.2 releases · first seen Oct 2026▸
release
New sandboxes on Kubernetes, Docker, Podman, and VM now open the control connection from sandbox to supervisor in the opposite direction; supervisor and sandbox runtime binaries must be upgraded together because older binaries reject the new sandboxes.
v0.1.6 · Oct 2026
· source
· release history
New sandboxes on Kubernetes, Docker, Podman, and VM open the control connection from sandbox to supervisor in the opposite direction from before; older supervisor and sandbox runtime binaries reject new sandboxes, so both must be upgraded together.
v0.1.6 · Oct 2026
· source
· release history
+Agent-driven policy managementshippedEnables the OpenShell agent to automate policy control and participate in enforcement decisions.2 releases · first seen May 2026▸
release
Adds agent-driven policy management, enabling the agent to participate in policy enforcement decisions.
v0.0.41 · May 2026
· source
· release history
Adds agent-driven policy management MVP, enabling automated policy control through the OpenShell agent.
v0.0.38 · May 2026
· source
· release history
+Containerized CLI executionshippedRuns the CLI inside a container with a corrected OAuth callback so browser-based login completes correctly in that environment.1 other source · first seen Nov 2026▸
Also counts toward: Command-line interface
example
Run the CLI inside a container and fix the OAuth callback so browser login completes correctly.$ docker run --rm -e OPENSHELL_CALLBACK_PORT=9876 -e OPENSHELL_CALLBACK_BIND_ADDRESS=0.0.0.0 -p 9876:9876 my-openshell-cli openshell gateway login
v0.1.7 · Nov 2026
· source
+Typed Python gRPC SDKshippedShips typed synchronous and asynchronous Python gRPC stubs so editors and type checkers have visibility into concrete request and response types.1 release · first seen Nov 2026▸
Also counts toward: gRPC API support, Client SDKs
release
The Python gRPC bindings now ship typed sync and async stubs, giving editors and type checkers visibility into concrete request and response types.
v0.1.7 · Nov 2026
· source
· release history
+Supervisor push-based config deliveryshippedAllows the supervisor to receive configuration changes pushed over the gateway session in approximately 100 ms instead of polling at up to 10-second intervals.1 release · first seen Oct 2026▸
release
Adds config_delivery_mode = "push" supervisor setting to receive configuration changes pushed over the gateway session in ~100 ms instead of up to 10 seconds; polling remains the default.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
v0.1.5 · Oct 2026
· source
· release history
+Local sandbox repository root configurationverifiedAllows users to specify a repository root path when running sandboxes locally via the CLI.1 other source · first seen Sep 2026▸
+Human-in-the-loop policy approvalshippedIntroduces an approval workflow in the policy engine for manual oversight of agent actions.1 release · first seen Jun 2026▸
release
Adds an agentic approval loop to the policy engine for human-in-the-loop control over agent actions.
v0.0.53 · Jun 2026
· source
· release history
Lines in monospace are the tool's own words: help text
parsed from its source, or an endpoint from its API document. Under
release, a line is our summary of a dated release. Under
docs, it is quoted from the tool's own documentation or
website. Each links back to the source it came from.
Command line
View
Source
No command matches.
load a captured run
composed command
No matchesTry a different search, or clear a filter to see more.
option surface across analysed releases
options at that releaseadded, per releaseremoved, per release
option
found in
since
description
No matchesTry a different search, or clear a filter to see more.
option changes per release — drag across the rail to set a range
→
Values are placeholders taken from each option’s declared default.
Nothing is executed here — the output shown is a recording of a run
that already happened.
Score card
Shipping velocityreleases a month, last 12 months
Documentation qualityrelease-notes rubric, 0–100
Breaking-change disciplinehow rarely a release breaks users, and notice given
Maintenance riskquiet time against its own cadence, maintainers
Innovation & surfacenew capabilities, API and MCP surface
Community health
Contributor trenddistinct committers, this year against last
Maintainer concentrationbus factor now against a year ago
Issue backlog trendissues closed per issue opened, 12 months
Responsivenessmedian time to a maintainer’s first reply
Nine scores for OpenShell, each built from the releases, notes and API history this site tracks — and, on Researcher and Business, where it stands among every measured tool in its category and how that has moved.
Each score is 0–100 on a published rubric, derived from data this site already shows.
A dimension we cannot measure says so — it is never scored 0 and never enters a rank.
How this is scored
Shipping velocity — releases a month over the last 12 months, on a log scale where 16 a month scores 100. Needs 3 releases in the window.
Documentation quality — the release-notes rubric published on the analytics page, unchanged.
Breaking-change discipline — the share of releases carrying a breaking change (none scores 100, half or more scores 0). Only projects that label breaking changes are measured: a clean record cannot be told from an unlabelled one.
Maintenance risk — quiet time measured against the tool's own release cadence (quiet longer than 90 days and three typical gaps scores 0), plus the number of active maintainers and whether contributors are growing, where known. Higher is lower risk.
Innovation & surface — new capabilities in the feature ledger this year, API and MCP operations added, and the share of commits that are features: the mean of whichever we hold.
Community health (open-source tools only) — each is a direction, not a size: contributors this year against last, the bus factor now against a year ago, and issues closed per issue opened, where steady scores 50, doubled 100 and halved 0; plus the median time to a maintainer's first reply (an hour scores about 100, a month or more 0). A commercial card has no repository and carries none of the four.
Documented delivery (commercial tools) — when a vendor's documented new capabilities have slowed against its own baseline, that counts against the overall standing as heavily as two low dimensions. Steady delivery, or too little history to judge, leaves the standing alone; it is never a sixth score.
Open-source tools are scored on repository signals; commercial tools on their published changelog. Ranks compare tools within one category and one profile and need at least five measured peers; the overall standing needs three ranked dimensions. Best-in-breed or consolidator is a shape, not a quality, and is never scored.
Release-note detail over time
See how much detail OpenShell puts in its release notes, quarter by quarter, and compare it with tracked tools in the same category. This history uses up to ten retained, reviewed notes per tool; sparse or blank older quarters may reflect that limit.
6 readings of NVIDIA's pricing page since Jun 2026, with 1 relaunch of its plan lineup and 2 changes to what its plans include — each one dated, compared with the reading before it, and explained for someone buying the tool.
Pricing and packaging history is included with Researcher and Business. See how every vendor we track sells, and how that has changed over time, using data we don't publish anywhere else.
Each offering on the pricing page links to its own page of plans, read at its latest capture.
Plan relaunches
Plans, prices and descriptions are quoted from the vendor's own pricing page as we read it on each date.
A plan missing from a later reading is shown as no longer listed on the page — a statement about the page, not the product.
Readings that failed to show any plans are left out rather than read as a change.
Website history
nvidia.com, every change
NVIDIA's home page and 40 more pages as they looked each month from September 2021 to October 2026: 54 renders, 10 changes of tagline or palette. Step through them, play them, or put any two months side by side.
Website history is included with Researcher and Business.
Nothing first seen in this window. That doesn't mean OpenShell shipped nothing, only that we found no record of it.
Changes per month New Updated Retired
2026-10
1
How we count
Read from 4 of 71 release notes and docs updates we hold for OpenShell. "First seen" is the earliest note that names something; "last" is the latest. Our history may start partway through OpenShell's life, so an old integration can show a recent first-seen date.
Each change counts once: "added 40 checks" is one line, so the numbers measure how often coverage moves, not how big the catalogue is or how well it detects.
Releases
Show
Coverage in all entries
71 entries
No entries match these filters.
November 20261
October 20264
September 20261
August 202613
July 202610
June 202611
May 202613
April 202611
March 20267
Project health
Issue, contributor and maintainer activity in NVIDIA/OpenShell, 2023-10 – 2026-09,
as of 2026-09-25. Twelve-month figures first; the trend lines run
the whole window.
Contributors141+141 vs prior 12 months
Maintainers16+16 joined · −0 left, last 12 months
Bus factor4committers behind half the commits
Community-filed57%of issues opened, last 12 months
Median time to close7.9 daysfirst maintainer reply 45 hours
Open backlog400of 1,131 issues ever filed
Issues opened / month36 · 21communitymaintainers
Open backlog400
Contributors / month47
Commits / month273
Stars8,609
Issue themes, last 12 months
features 3%
questions 0%
docs 2%
other 95%
Counts from the project's public repository and git history; no individuals
are identified. Maintainers are the committers covering 80% of the last year's
commits. how we measure this
Add the badge to your README
Maintain this project? The badge links readers straight to this page, so they can
follow every release here.