PAGES
← all tools
◆ AI/LLM Security

OpenShell

v0.1.7 open-source

OpenShell runs autonomous AI agents in policy-controlled sandboxes with isolated filesystem, network, and credential access.

Summary

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.

How OpenShell helps

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

all 51 features, with the evidence for each →

Languages

Not documented

Features

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.

Compare with peers →

  • 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
Sandbox Orchestration and Lifecycle 6 capabilities OpenShell'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 configuration shipped Controls 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 runner verified Lets 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

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 coordination shipped Coordinates 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 removals shipped Documents 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 agent shipped Lets 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

example

  • Install OpenShell agent skills npx skills add NVIDIA/OpenShell
Kubernetes agent-sandbox integration shipped Allows 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 Control 3 capabilities OpenShell 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 control shipped Routes 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 enforcement shipped Enforces 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 framework shipped suggested Provides 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
  • Introduces supervisor middleware framework (RFC-0009) enabling extensible sandbox lifecycle hooks. v0.0.86 · Jul 2026 · source · release history
Security Policy and Access Control 5 capabilities OpenShell 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 management shipped Manages 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 warning shipped suggested Warns 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 resolution shipped Uses 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 configuration shipped Configures 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 visibility shipped Exposes 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 Integration 1 capability OpenShell 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 management shipped Integrates 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 Tooling 3 capabilities OpenShell 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 observability shipped Exports 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 output verified Outputs 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

command line

example 8 total

  • 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) shipped Provides 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 Support 3 capabilities OpenShell 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 support shipped Provides 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 support shipped Compiles 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 support shipped Offers 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
Other 2 capabilities Capabilities that did not group under any area above.
Container runtime security controls shipped Applies 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 termination shipped Terminates 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
Other 28 capabilities
Infrastructure and deployment configuration shipped Manages 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 injection shipped Supports 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) shipped Provides 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 configuration shipped Configures 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 emission shipped Emits 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 management shipped Manages 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 providers shipped Integrates 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 authentication shipped Manages 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 execution shipped Provides 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
  • Adds sandbox exec subcommand with TTY support, enabling interactive terminal sessions inside sandboxed environments. v0.0.23 · Apr 2026 · source · release 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
  • 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 profiles shipped Enforces 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
  • Supports provider profile updates. v0.0.69 · Jun 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 mutation shipped Intercepts 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 management verified Enables 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 support shipped Allows 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 resume shipped Allows 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 option shipped Provides 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 publishing shipped Publishes 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 provisioning shipped Supports 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 flags verified Allows users to attach non-secret metadata annotations and specify a branch when running sandboxes via the CLI. 3 other sources · first seen Oct 2026

Also counts toward: Command-line interface

command line

Headless CLI authentication shipped Runs 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 supervisor shipped Runs 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 distribution shipped Publishes 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 architecture shipped Opens 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 management shipped Enables 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 execution shipped Runs 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 SDK shipped Ships 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 delivery shipped Allows 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 configuration verified Allows users to specify a repository root path when running sandboxes locally via the CLI. 1 other source · first seen Sep 2026

command line

Human-in-the-loop policy approval shipped Introduces 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.

Score card

  1. Shipping velocity releases a month, last 12 months
  2. Documentation quality release-notes rubric, 0–100
  3. Breaking-change discipline how rarely a release breaks users, and notice given
  4. Maintenance risk quiet time against its own cadence, maintainers
  5. Innovation & surface new capabilities, API and MCP surface
  6. Community health
  7. Contributor trend distinct committers, this year against last
  8. Maintainer concentration bus factor now against a year ago
  9. Issue backlog trend issues closed per issue opened, 12 months
  10. Responsiveness median 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.

Score cards are part of every paid plan.

See plans →

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.

Checking release-note history…

Explore the full chart →

Commercials

pricing & packaging history · NVIDIA vendor page

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.

See plans →

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.

See plans →

Coverage

Missing something? Tell us

What OpenShell connects to, runs on and detects, read from its release notes and docs. So far: 1 new integration.

Show

1 change, tracked since Oct 9, 2026.

  • Oct 92026

    new Oracle Cloud Infrastructure Generative AI provider profile

    feat(providers): add Oracle Cloud Infrastructure Generative AI provider profile by @fede-kamel in https://github.com/NVIDIA/OpenShell/pull/3904

    v0.1.3 Source ↗

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

  1. November 20261
  2. October 20264
  3. September 20261
  4. August 202613
  5. July 202610
  6. June 202611
  7. May 202613
  8. April 202611
  9. March 20267
    Show
    Coverage in all entries

    71 entries

    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.

    1. Contributors 141 +141 vs prior 12 months
    2. Maintainers 16 +16 joined · −0 left, last 12 months
    3. Bus factor 4 committers behind half the commits
    4. Community-filed 57% of issues opened, last 12 months
    5. Median time to close 7.9 days first maintainer reply 45 hours
    6. Open backlog 400 of 1,131 issues ever filed
    1. Issues opened / month 36 · 21 communitymaintainers
    2. Open backlog 400
    3. Contributors / month 47
    4. Commits / month 273
    5. Stars 8,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.

    Tracked by Cyber Toolchain Choose a badge style and copy the code →
    browse all tools → score card for your toolchain →