LaunchedEditorial Listing

NVIDIA OpenShell

NVIDIA · NVIDIA OpenShell: Open-Source Sandboxed Runtime for AI Agents

Open NVIDIA OpenShell

NVIDIA OpenShell is an open-source (Apache 2.0) runtime that runs existing AI agents, such as Claude Code, Codex, OpenCode, or GitHub Copilot CLI, inside kernel-isolated sandboxes governed by YAML policies. It controls which files, network destinations, and credentials each agent can use, and checks proposed policy changes before they are approved. It suits developers and platform teams who want to give agents real access without giving them unrestricted access to their machines, secrets, or network.

PricingFree
Setupmedium
Runs onSelf-hosted
APIYes
Open sourceYes
DocsYes
Agent InfrastructureSandboxOpen SourceSelf-HostedSecurityGovernanceHuman-in-the-LoopKubernetes

Best for

Developers and platform or security teams who run coding or autonomous agents with real file, network, and credential access and want enforceable, reviewable limits outside the agent itself

Not ideal for

Anyone looking for an agent to do the work, teams without the Linux, container, or Kubernetes skills to maintain images and policies, and hosts on older kernels or Windows where support is limited or experimental

Who it's for

Developers running coding agents locally, and platform, security, and infrastructure teams responsible for how agents access code, credentials, and networks

Capabilities

  • Runs any agent available in an OCI image, including Claude Code, Codex, OpenCode, GitHub Copilot CLI, and Pi, as the main process of an isolated sandbox
  • Kernel-level enforcement: non-root workload with no Linux capabilities, Landlock filesystem rules, and seccomp-based mediation of every TCP connection and DNS lookup
  • Deny-by-default network policy with per-binary destination rules and request-level restrictions, such as allowing reads but not writes to an API
  • Providers store credentials outside the sandbox. The agent gets opaque placeholders, and the real credential is added only to requests bound for endpoints the provider profile authorizes
  • Policy advisor turns denied requests into narrow proposed rules that you approve or reject from the CLI, and approved rules hot-reload into the running sandbox
  • Policy prover uses an SMT solver to flag risky proposals (new credentialed hosts, new HTTP methods, cloud metadata access) and to check a policy against a boundary policy in CI with `openshell-prover`
  • Global policies let a gateway administrator apply one policy to every sandbox
  • Compute drivers for Docker, Podman, Kubernetes (Helm chart, using the Kubernetes SIG Agent Sandbox controller), and libkrun microVMs
  • GPU requests with `--gpu`, using NVIDIA CDI devices on Docker and Podman and `nvidia.com/gpu` limits on Kubernetes
  • Example provider profiles for hosted inference APIs such as NVIDIA, OpenAI, Anthropic, and Google Vertex AI, plus custom profiles for self-hosted endpoints such as Ollama
  • SDKs for Python, TypeScript, Go, and Rust, plus agent skills (`npx skills add NVIDIA/OpenShell`) that teach coding agents to drive the CLI and write policies
  • Stable releases generally every week since 0.1.0, with security and critical reliability fixes for the latest and previous minor lines

Limitations

  • OpenShell does not include an agent. The default workload image is minimal Ubuntu with no agent CLI installed, so you build or choose an image that contains your agent and tools
  • The sandbox boundary needs Landlock ABI 3 (upstream Linux 6.2 or newer, or a qualifying backport) and specific seccomp features, and fails closed without them. Kernels older than 5.19, such as RHEL 9's 5.14, run in a reduced legacy read-only mode where some socket calls, such as getpeername, fail with EOPNOTSUPP
  • The CLI and gateway are supported on Debian and Ubuntu Linux (x86_64 and arm64) and Apple Silicon macOS with Docker Desktop. Windows through WSL 2 is experimental
  • Kubernetes deployments require a CNI that enforces NetworkPolicy for ingress and egress. Without it, sandbox workloads may bypass the supervisor's policy
  • The policy prover covers filesystem, process, Landlock, network, and REST rules. Policies that use GraphQL or MCP rules are reported as uncheckable
  • 0.1.0 introduced breaking changes: 0.0.x installations cannot be upgraded in place, every sandbox must be recreated, and provider profiles must be exported and re-imported
  • Anonymous operational telemetry is collected by default and must be disabled on the gateway if you do not want it
  • The Sentry hardware watchdog in NVIDIA's Open Agent Safety Platform is a separate reference design that needs BlueField-4 DPUs. It is not part of the OpenShell software

Use cases

  • Running Claude Code or OpenCode on a project with access limited to the workspace and the model provider's API
  • Giving an agent a GitHub token that resolves only on GitHub's own endpoints, so the agent never sees the real value and cannot send it elsewhere
  • Reviewing and approving the network access an agent asks for as it works, instead of granting broad access up front
  • Checking in CI that a sandbox policy stays within an organization's maximum allowed boundary with `openshell-prover`
  • Hosting shared, policy-controlled agent sandboxes for a team on Kubernetes with the Helm chart
  • Pointing sandboxed agents at a self-hosted or private model endpoint while blocking all other model providers

Our take

OpenShell addresses a gap that most coding agents leave to their users: permission prompts inside the agent are not a security boundary, and agents run with whatever access their user account has. OpenShell moves enforcement to the kernel and a supervisor the agent cannot reach, and its best idea is keeping real credentials out of the sandbox entirely. The policy advisor and prover make least-privilege workable, because access can grow as the agent needs it and each change is checked first. The costs are operational. You own the images, the policies, and the kernel requirements, and on Kubernetes the guarantees are only as strong as your CNI. For teams already letting agents touch real code and secrets, it is a strong option to evaluate, and solo developers can try it with Docker on a laptop.

Who should use it

Developers who let coding agents run commands on real projects, and platform or security teams that need to prove what agents can access, keep credentials out of agent reach, and review access changes before they take effect.

Who should skip it

People looking for an agent rather than infrastructure, teams unwilling to maintain container images and YAML policies, and environments on older kernels, native Windows, or Kubernetes clusters without NetworkPolicy enforcement.

Strengths

  • Apache 2.0 licensed and free to use
  • Enforces limits outside the agent, so it works with agents you already use
  • Credentials never enter the sandbox and only reach approved endpoints
  • Denied requests turn into narrow, prover-checked rules you can approve without restarting
  • Runs on a laptop with Docker or Podman, and also on Kubernetes or in microVMs

Weaknesses

  • You build and maintain agent images and policies yourself
  • Strict Linux kernel requirements, and Windows support is experimental
  • Kubernetes isolation depends on a CNI that actually enforces NetworkPolicy
  • Young project with breaking changes in 0.1.0 and a prover that does not cover every rule type

NVIDIA OpenShell pricing

Open source

Free

  • Apache 2.0 license
  • CLI, gateway, sandbox runtime, and policy prover
  • Docker, Podman, Kubernetes (Helm), and microVM runtimes
  • Python, TypeScript, Go, and Rust SDKs

Note: NVIDIA lists no paid edition of OpenShell. Costs come from the infrastructure you run it on and the model APIs your agents call. The Sentry watchdog in NVIDIA's Open Agent Safety Platform requires BlueField-4 DPU hardware and is separate from the OpenShell software.

Technical specs

Where NVIDIA OpenShell excels

Letting a coding agent work on a private repository

Filesystem rules confine the agent to the workspace, the default network policy blocks uploads to unapproved hosts, and the model and Git credentials only reach their own endpoints.

Least-privilege access that grows with the task

Instead of guessing every domain up front, you start restrictive. The policy advisor drafts a rule for each blocked request, the prover flags risky ones, and you approve what is needed without restarting the sandbox.

Standard agent guardrails across a team

A gateway administrator can apply a global policy to every sandbox, and `openshell-prover` can check in CI that team policies never exceed an approved boundary.

How NVIDIA OpenShell fits alongside other tools

NVIDIA OpenShell and Claude Code

Claude Code is the agent: it reads the codebase, edits files, and runs commands, with its own permission prompts. OpenShell can run Claude Code as a sandbox's main process and enforce, outside the agent, which paths it can touch, which hosts it can reach, and where its Anthropic API key can be sent.

NVIDIA OpenShell and OpenCode

OpenCode is an open-source coding agent that works with many model providers. OpenShell's getting-started guide runs OpenCode against OpenRouter inside a sandbox, where the OpenRouter credential is sent only to openrouter.ai and new network access is requested and approved as the agent works.

NVIDIA OpenShell and Pi Coding Agent

Pi is a minimal coding agent that runs with its user's permissions and does not ask before each tool call. OpenShell supplies the boundary around it: OpenShell's Run Pi with OpenRouter tutorial builds a Pi image and runs it with narrowly scoped OpenRouter access inside a sandbox.

Frequently asked questions

What is NVIDIA OpenShell?

OpenShell is NVIDIA's open-source runtime for running autonomous AI agents in sandboxes. Each agent runs inside a kernel-isolated boundary, and a trusted supervisor enforces a YAML policy on file access, processes, network connections, and credentials. A gateway manages sandboxes, policies, and providers.

Is OpenShell an AI agent?

No. OpenShell does not plan or write code itself. It runs agents you already use, such as Claude Code, Codex, OpenCode, GitHub Copilot CLI, or Pi, as the main process of a sandbox, and controls what they can reach.

Is OpenShell free and open source?

Yes. The code is on GitHub at NVIDIA/OpenShell under the Apache 2.0 license, and NVIDIA lists no paid edition of the software. You still pay for any model APIs your agents call and for the infrastructure you run it on.

How does OpenShell protect credentials?

Credentials are stored as providers on the gateway side. The sandbox receives only opaque placeholders, and the supervisor substitutes the real value on requests to endpoints that the provider profile authorizes. A leaked environment variable or a request to an unapproved host does not carry the real key.

What platforms does OpenShell support?

The CLI and gateway are supported on Debian and Ubuntu Linux (x86_64 and arm64) and on Apple Silicon macOS with Docker Desktop. Windows with WSL 2 and Docker Desktop is experimental. Sandboxes run on Docker, Podman, Kubernetes 1.29+ through the Helm chart, or libkrun microVMs. The sandbox boundary needs Landlock ABI 3 (Linux 6.2 or newer) and specific seccomp support; on macOS these run inside the Docker Desktop Linux VM.

Can OpenShell run on Kubernetes?

Yes. The gateway is deployed with a Helm chart and provisions sandboxes through the Kubernetes SIG Agent Sandbox controller, which must be installed first. The cluster needs Kubernetes 1.29+ with RBAC and a CNI that enforces NetworkPolicy for both ingress and egress, otherwise workloads could bypass policy.

What is the difference between OpenShell and NVIDIA Sentry?

OpenShell is the open-source software runtime. Sentry is part of NVIDIA's Open Agent Safety Platform reference design: an out-of-band watchdog that runs on BlueField-4 DPUs, monitors agent behavior, and can quarantine an agent that tries to leave its software boundary. You can use OpenShell without Sentry.

Does OpenShell collect telemetry?

Yes, anonymous operational telemetry limited to categories and counts. NVIDIA says it does not collect sandbox names, hostnames, file paths, prompts, credentials, provider or model names, or user content. Set `OPENSHELL_TELEMETRY_ENABLED=false` on the gateway, or `server.telemetryEnabled=false` for Helm installs, to turn it off.

Integrations & fit

Claude CodeOpenAI CodexOpenCodeGitHub Copilot CLIPiDockerPodmanKubernetes (Helm)Kubernetes Agent SandboxNVIDIA GPUs (CDI)NVIDIA APIOpenAIAnthropicOpenRouterOllamaGitHubGoogle Vertex AIMicrosoft GraphSlackClaude Managed Agents
Good fit forSolo / individual, Startup / small team, Enterprise
Pricing modelFree· No cost to start
See pricing on NVIDIA OpenShell →

About NVIDIA OpenShell

OpenShell is not an agent. It is the boundary you run an agent inside. A gateway acts as the control plane, and for each sandbox a compute driver starts the agent's workload next to a separate, trusted supervisor. Inside the workload the agent runs as a non-root user with no Linux capabilities, Landlock limits which paths it can read or write, and seccomp hands every TCP connection and DNS lookup to the supervisor, which checks it against policy before opening the real connection. Network access is denied by default. Policies allow specific destinations per program and can restrict the requests sent, for example read-only access to an API. Credentials are stored as providers, and the agent only sees placeholders, which the supervisor swaps for the real key on requests to endpoints the provider profile allows. When the agent hits a blocked destination, OpenShell drafts a narrow rule, and a policy prover that uses an SMT solver checks it for risky new access, such as credentialed reach to a new host or cloud metadata endpoints, before a human approves it. Approved rules hot-reload without restarting the sandbox. Sandboxes run on Docker, Podman, Kubernetes (Helm), or microVMs, can request NVIDIA GPUs, and use standard Linux OCI images, so you bring an image that already contains your agent. OpenShell 0.1.0 (September 25, 2026) moved the project to a stable release cadence, with tagged stable releases generally every week. Three days later NVIDIA declared OpenShell broadly available as the open-source software part of its Open Agent Safety Platform, which also includes the Sentry watchdog reference design for BlueField-4 DPUs. The tradeoffs are setup and scope. You write or adapt policies and images yourself, Linux hosts need a recent kernel with Landlock and specific seccomp features, Kubernetes needs a CNI that enforces NetworkPolicy, and the prover does not yet cover every policy feature.

Updates from NVIDIA OpenShell

LaunchNVIDIA makes OpenShell broadly available in its Open Agent Safety Platform

NVIDIA announced the Open Agent Safety Platform, pairing OpenShell with the Sentry watchdog reference design for BlueField-4 DPUs, and said OpenShell is now broadly available. The announcement lists Anthropic, Salesforce (a Slack integration for approving OpenShell requests), SAP, and Scale AI among the organizations working with the platform.

New FeatureOpenShell 0.1.0 starts a stable release cadence

OpenShell 0.1.0 introduced a stable release cadence, new isolation primitives, an expanded extension surface, and new APIs. It includes breaking changes: 0.0.x installations cannot be upgraded in place and must be uninstalled, and existing sandboxes must be recreated.

Are you the founder? Claim this listing →